docs(progress): record human review package push

.learnings/ERRORS.md

@@ -2,12 +2,275 @@
 
 Command failures and integration errors.
 
+---
+## [ERR-20260920-042] pdf-runtime-path-mismatch
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: environment
+
+### Summary
+Neither `pdftotext` nor `pypdf` was available in the project/system Python path used for the first survey-design source extraction attempt.
+
+### Error
+PowerShell could not find `pdftotext`; project Python raised `ModuleNotFoundError: pypdf`.
+
+### Context
+The failures were read-only and occurred before any design decision was recorded.
+
+### Suggested Fix
+Use the Codex workspace PDF runtime returned by the workspace dependency loader for document extraction; keep statistical builders in `.venv-research`.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/survey_design_source_audit.md`
+- Pattern-Key: environment.pdf-runtime-path
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Official guide pages were extracted with the bundled PDF runtime and cross-checked against local fields.
+
+---
+## [ERR-20260920-041] gitea-cached-credential-rejected
+
+**Logged**: 2026-09-20
+**Priority**: medium
+**Status**: resolved
+**Area**: infra
+
+### Summary
+Gitea rejected the cached credential while pushing the verified response-layer commit.
+
+### Error
+`remote: Failed to authenticate user` and `fatal: Authentication failed`.
+
+### Context
+Local commit `89c20f3` was created successfully; no remote history changed. Earlier pushes to the same URL succeeded.
+
+### Suggested Fix
+Use the configured Git Credential Manager to refresh only the `git.jinome.org` credential, then push all pending commits and verify local/remote HEAD equality.
+
+### Metadata
+- Reproducible: not yet known
+- Related Files: `.git/config`, `Progression.md`
+- Pattern-Key: git.cached-credential-rejected
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Cleared only the stale `git.jinome.org` credential, reauthorized through Git Credential Manager, and pushed both pending commits.
+
+---
+## [ERR-20260920-040] system-python-missing-project-package
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: environment
+
+### Summary
+The first response-long build was launched with system Python, which does not contain the locked project package set.
+
+### Error
+`ModuleNotFoundError: No module named 'duckdb'`
+
+### Context
+The import failed before source data were read or an output table was created. The project environment is `.venv-research`.
+
+### Suggested Fix
+Run research builders with `.venv-research/Scripts/python.exe` and reserve system Python for dependency-free diagnostics.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/build_responses_long.py`, `research/audit/environment_audit.md`
+- Pattern-Key: environment.wrong-python-runtime
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Re-ran with the locked project Python; the long table and independent checks completed.
+
+---
+## [ERR-20260920-026] sas-input-block-comment-collision
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: data
+
+### Summary
+The first YRBS fixed-width layout parser matched the words “Input Program” in the SAS header comment instead of the executable `Input` statement.
+
+### Error
+`ValueError: No fields parsed` for the official 2021 SAS input program.
+
+### Context
+The broad first-occurrence regular expression selected a comment fragment. No Parquet or audit output was written.
+
+### Suggested Fix
+Anchor the parser to a line containing only the SAS `Input` keyword, then parse the following field declarations.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/import_yrbs_2021_2023.py`
+- Pattern-Key: parser.comment-keyword-collision
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: The input-block expression is line-anchored and the import is rerun from the official files.
+
+---
+## [ERR-20260920-036] pdf-text-console-encoding
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: docs
+
+### Summary
+An exploratory YRBS PDF text scan stopped when Windows console encoding could not print a soft-hyphen character.
+
+### Error
+`UnicodeEncodeError: 'gbk' codec can't encode character`.
+
+### Context
+PDF extraction itself succeeded; only diagnostic console output failed. Source files were unchanged.
+
+### Suggested Fix
+Configure diagnostic stdout as UTF-8 with replacement before printing extracted PDF text.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/yrbs_primary_outcome_source_audit.json`
+- Pattern-Key: docs.console-encoding
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: The scan was rerun with UTF-8 stdout and all annual source pages were reviewed.
+
+---
+## [ERR-20260920-035] gshs-questionnaire-directory-assumption
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: docs
+
+### Summary
+The first questionnaire inventory command assumed a non-existent `03_questionnaires_and_codebooks` directory.
+
+### Error
+`rg` returned an OS error because that path does not exist.
+
+### Context
+The dataset uses `GSHS/Questionnaire`, while `03_examples` is a separate directory. No files were changed.
+
+### Suggested Fix
+Enumerate the GSHS root before applying a documentation-path convention.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire`
+- Pattern-Key: docs.path-assumption
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Enumerating the root located the actual questionnaire directory and the audit continued there.
+
+---
+## [ERR-20260920-034] project-python-document-parser-missing
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: dependencies
+
+### Summary
+The project research environment does not include `python-docx`, `pypdf`, or `pdfplumber`, so an exploratory source-extraction import failed.
+
+### Error
+`ModuleNotFoundError: No module named 'docx'`.
+
+### Context
+These packages are available in the Codex bundled document runtime. The final component audit uses only the project standard library and records verified source paths, pages/sections, and hashes, so it does not introduce an undeclared runtime dependency.
+
+### Suggested Fix
+Use the bundled read-only document runtime for source inspection unless document parsing becomes a reproducible project pipeline dependency; only then add and lock the packages in the project environment.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/gshs_primary_outcome_component_audit.json`
+- Pattern-Key: dependency.optional-document-parser
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Source text was extracted with the bundled runtime and key PDF pages were rendered with Poppler for visual verification.
+
+---
+## [ERR-20260920-033] repeated-gshs-pandas-memory-exhaustion
+
+**Logged**: 2026-09-20
+**Priority**: medium
+**Status**: resolved
+**Area**: runtime
+
+### Summary
+An exploratory pandas cross-tab scan again exhausted memory while parsing the 637-column GSHS CSV.
+
+### Error
+`pandas.errors.ParserError: Error tokenizing data. C error: out of memory`.
+
+### Context
+This is a recurrence of `ERR-20260920-029` during a new component-level relation check. The source file was not changed.
+
+### Suggested Fix
+Use a streaming `csv.reader` scan with fixed column indices for all full-file GSHS audits.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/audit_gshs_primary_outcome_components.py`
+- Pattern-Key: runtime.memory-exhaustion
+- Related Error: `ERR-20260920-029`
+- Recurrence Count: 2
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: The streaming audit completed all 673,499 rows, all 191 components, and all three raw/binary relationship checks without a dense pandas load.
+
+---
+## [ERR-20260920-032] samhsa-pdf-direct-fetch-forbidden
+
+**Logged**: 2026-09-20
+**Priority**: medium
+**Status**: resolved
+**Area**: docs
+
+### Summary
+SAMHSA PDF endpoints returned HTTP 403 to the web reader, direct download, and in-app browser during the NSDUH source audit.
+
+### Error
+`403 Forbidden` from the official PDF URLs; the sandboxed first download attempt also had no network route.
+
+### Context
+The official documents remained indexed with searchable text, and SAMHSA HTML methodology pages plus year-specific search extracts exposed the required question, routing, variable, and disclosure-risk statements. No local or remote data were changed by the failed reads.
+
+### Suggested Fix
+Use SAMHSA's indexed official-document text and HTML pages for this audit, retain exact source URLs, and keep page-level PDF visual verification pending rather than claiming it occurred.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/nsduh_youth_attempt_source_audit.md`
+- Pattern-Key: net.access-forbidden
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Triangulated the claim across official 2021–2023 restricted-use codebooks, the 2024 questionnaire, 2024 methodology definitions, the 2024 public-use guide, and the local public-use schema. Direct PDF page rendering remains explicitly unverified.
+
 ---
 ## [ERR-20260920-031] git-https-authentication-rejected
 
 **Logged**: 2026-09-20
 **Priority**: high
-**Status**: pending
+**Status**: resolved
 **Area**: infra
 
 ### Summary
@@ -27,6 +290,10 @@ Reauthorize the `git.jinome.org` entry through Git Credential Manager, then retr
 - Related Files: `.git/config`, `Progression.md`
 - Pattern-Key: auth.token-expired
 
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Removed only the rejected `git.jinome.org` cached entry, reauthorized through Git Credential Manager, and pushed local `main` through `ca67e1f` without storing credentials in the repository.
+
 ---
 ## [ERR-20260920-030] gshs-workbook-column-name
 
@@ -904,3 +1171,90 @@ Remove the override and tolerate the harmless warning, or use an actual readable
 - **Notes**: The override is removed; no index changes occurred in the failed attempt.
 
 ---
+## [ERR-20260920-037] parquet-field-name-assumption
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: data
+
+### Summary
+A diagnostic PyArrow read requested a non-existent `survey_year` field from the NSDUH full Parquet.
+
+### Error
+The full NSDUH schema uses `YEAR`, not `survey_year`.
+
+### Context
+The field name was inferred from the YRBS convention instead of checked against the NSDUH schema. No data were modified.
+
+### Suggested Fix
+Inspect the authoritative schema before column projection and use the source-specific `YEAR` field; DuckDB then verified the intended annual counts.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_2021_2024_full.parquet`
+- Pattern-Key: schema.field-name-assumption
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Re-ran the count query against `YEAR` and obtained annual distributions for `YUSUITHK` and `YUSUIPLN`.
+
+---
+## [ERR-20260920-038] yrbs-attempt-response-shape
+
+**Logged**: 2026-09-20
+**Priority**: medium
+**Status**: resolved
+**Area**: data
+
+### Summary
+The first Gate-1 package build assumed all YRBS primary outcomes were binary and stopped on attempt response code 3.
+
+### Error
+`ValueError: Unsupported response code: survey='YRBS' construct='suicide_attempt' code='3' label='2 or 3 times'`
+
+### Context
+Annual source audits correctly retained five attempt-frequency categories, but the canonical response function handled the ordinal mapping only for GSHS. The fail-closed check prevented output files from being written.
+
+### Suggested Fix
+Apply the shared five-level frequency mapping to both GSHS and YRBS attempt items and rerun all package validations.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/build_primary_outcome_package.py`, `research/stage1/yrbs_primary_outcome_source_audit.json`
+- Pattern-Key: response-dictionary.shape-assumption
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Canonical attempt categories are now `zero`, `one`, `two_or_three`, `four_or_five`, and `six_or_more` in both surveys.
+
+---
+## [ERR-20260920-039] sas-input-parser-edge-cases
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: data
+
+### Summary
+The first two YRBS fixed-width parser attempts encountered a SAS header-comment keyword collision and the SAS numeric missing token `.`.
+
+### Error
+The first attempt found no layout fields; the second could not convert `.` to a float.
+
+### Context
+Both failures occurred before a complete Parquet/audit output was accepted.
+
+### Suggested Fix
+Anchor the layout parser to a line containing only `Input` and map the SAS numeric missing token `.` to null.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `research/stage1/import_yrbs_2021_2023.py`
+- Pattern-Key: parser.sas-fixed-width-edge-cases
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Both cases are handled explicitly and the official-layout import is rerun from source.
+
+---

Progression.md

@@ -1,9 +1,9 @@
 # 项目进度档案
 
-版本：1.8
+版本：1.17
 建立日期：2026-09-20  
 当前总状态：`in_progress`  
-当前阶段：阶段 1 `in_progress`；主要结局来源登记骨架已建立，直接来源复核与双人审核尚未完成
+当前阶段：阶段 1 `in_progress`；题库、回答字典、919,863 行回答长表及三调查设计字段/方法均已核验；Gate 1 仅剩主要结局的两名实际人工审核者签署
 
 ## 1. 管理规则
 
@@ -28,7 +28,7 @@
 | 阶段 | 名称 | 状态 | 当前判定 |
 |---|---|---|---|
 | 0 | 冻结研究问题、范围与版本 | `passed` | 四项交付物齐备，Gate 0 已通过；研究工具链补强与锁定完成 |
-| 1 | 有来源证据的题库和回答层 | `in_progress` | 数据契约、候选入口结构审计和主要结局来源登记骨架已完成；直接问卷核验、编码规则与人工双重审核尚未完成 |
+| 1 | 有来源证据的题库和回答层 | `in_progress` | 七项机器交付物齐备，来源/编码/总体/缺失与设计层已形成；尚缺工作流强制要求的两名实际审核者签署 |
 | 2 | 可行性、可识别性和连接审计 | `not_started` | 等待 Gate 1 |
 | 3 | 冻结验证协议与已知真值模拟 | `not_started` | 等待 Gate 2 |
 | 4 | 直接协调和传统基线 | `not_started` | 等待 Gate 3 |
@@ -81,13 +81,13 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 | 优先级 | 问题 | 影响 | 下一处理 |
 |---|---|---|---|
-| P0 | 官方题目文本、回答标签、适用总体和跳题规则尚未逐项核验 | Gate 1 与确认性分析不能通过 | 来源登记骨架已建立；下一步直接复核官方问卷/代码本，并保持 provisional 直到双人审核完成 |
+| P0 | 84 个主要结局实例尚未由两名实际审核者逐项签署，部分总体、实际施测语言和跳题细节仍为 provisional | Gate 1 与确认性分析不能通过 | 使用已导出的双审队列独立复核；AI 生成内容不得填入审核者栏 |
 | P0 | 题目共现、锚定图与可识别性尚未重算 | 不能确定 IRT/层级模型是否成立 | 完成阶段 1 后进入阶段 2 审计 |
 | P1 | 数据来源许可及可分发范围尚未逐来源完成最终复核 | 影响复现包与衍生数据交付 | 已在清单中显式标为 review required；阶段 1 按实际纳入来源逐项确认，不默认允许再分发 |
 | P1 | R、PyMC/ArviZ、心理测量包与 CUDA Toolkit 曾缺失 | 已解决：项目 Python/R 环境和 CUDA 端到端验收通过 | 后续仅按锁定文件维护；任何升级必须重跑三套烟雾测试 |
 | P1 | 文献初筛尚未形成可审计矩阵 | 研究定位和“贡献”表述仍不稳定 | 建立 literature matrix，记录 DOI、来源、证据层级和项目关系 |
-| P0 | NSDUH 本地完整字典未暴露青少年自杀尝试变量，虽 2022–2024 模块说明提到 `YSUI03`–`YSUI05` | NSDUH 不能被假定覆盖三项主要结局；跨工具任务可能只支持意念/计划 | 直接核验年度青少年问卷、代码本与公开使用文件抑制/派生说明 |
+| P0 | NSDUH 的 `YSUI03/YUSUICTRY` 已确认施测，但尝试及严重度字段不在当前本地公开使用数据中；2024 指南明确记录派生尝试变量因披露风险排除 | 当前微数据只能外部验证意念/计划，不能验证尝试 | 不从其他题推导尝试；如核心设计必须使用尝试，评估受限数据申请或预先设计的聚合结果方案 |
-| P1 | GSHS `_b_` 与无前缀题目版本、YRBS 年度题目文本仍缺直接官方文档复核 | 不能批准题目家族或跨调查锚定 | 按组件/年度建立直接来源证据和冲突清单 |
+| P1 | Solomon Islands 2023 已有 WHO 官方目录的逐题来源与总体资料，但未取得国家问卷文件/实际施测语言证据 | 不影响该组件的题文/编码来源，但限制语言字段批准 | 保持语言 provisional；在语言 DIF 分析前取得施测语言证据或排除相应主张 |
 
 ## 8. 行动日志
 
@@ -689,9 +689,131 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 - 质量边界：未直接核验年度 PDF/代码本页码；没有把 AI 检查登记为人类审核；没有批准任何构念等价、缺失重编码、题目家族或锚定关系。Gate 1 仍为 `in_progress`。
 - 工程修复：一次只读工作簿筛选错误使用 `column` 而非 `column_name`，无数据改动；修正后成功并记录为已解决的 `ERR-20260920-030`。
 - 提交状态：本地提交 `fb30b60` 已创建。
-- 推送状态：`push_failed`；远端拒绝现有 HTTPS 凭据，`origin/main` 仍为 `5c31417`。已记录 `ERR-20260920-031`，需通过 Git Credential Manager 重新授权后重试。
+- 推送状态：`pushed`；首次推送因缓存凭据被拒绝，随后仅清除 `git.jinome.org` 的失效条目并通过 Git Credential Manager 重新授权，提交 `fb30b60` 与审计提交 `ca67e1f` 已推送，`ERR-20260920-031` 已解决。
 - 下一步：直接核验 NSDUH 年度青少年问卷/代码本中的 `YSUI03`–`YSUI05` 与公开数据字段关系，同时建立 GSHS 组件级题目版本来源映射。
 
+### A-20260920-055：核清 NSDUH 青少年自杀尝试题与公开数据可用性
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取 `Document/research-workflow.md`、本进度档案并核对干净 Git 状态；以官方 2021–2023 restricted-use codebook、2024 questionnaire web specification、2024 methodology summary 和 public-use guide 核验 `YSUI03`–`YSUI05`，同时检查本地 complete dictionary 与 full/selected Parquet schema。
+- 输入：SAMHSA 六项官方来源；本地 `nsduh_complete_variable_dictionary.csv`、`nsduh_2021_2024_full.parquet`、`nsduh_2021_2024_selected.parquet`。
+- 输出：新增 `verify_nsduh_youth_attempt.py`、`nsduh_youth_attempt_source_audit.json`、`nsduh_youth_attempt_source_audit.md`；更新主要结局登记生成脚本及 v1.1 JSON/报告；更新 `.learnings/ERRORS.md`。
+- 检查：两个脚本通过 `py_compile`；机器审计确认 `YUSUICTRY`、两种已见派生拼写、医疗关注与住院随访共 7 个字段在本地 complete/full/selected 三处全部不存在；主要结局登记现有 69 条候选，其中 NSDUH 每个构念各 4 个年度来源记录，尝试记录全部明确标为本地不可分析；所有记录仍为 `provisional`，语义断言与 `git diff --check` 通过。
+- 新证据：`YSUI03/YUSUICTRY` 是 12–17 岁过去 12 个月尝试题，计划与尝试对所有该年龄受访者施测，不以意念阳性为前提；`YSUI04` 仅在尝试为是时询问医疗关注，`YSUI05` 仅在医疗关注为是时询问过夜住院；2021 位于 youth mental health service utilization，自 2022 起移至 youth experiences；2024 public-use guide 明确 `YUSUITRYYR` 因披露风险从文件排除。
+- 决策：撤销“可能未施测”的解释，改为“已施测但当前公开使用微数据不可用”。NSDUH 当前只可用于青少年意念和计划的个体层外部验证；尝试不能由意念、计划、COVID 条件题或随访题推导。
+- 质量边界：SAMHSA PDF 端点对网页读取、浏览器和直接下载均返回 HTTP 403；本次使用官方索引文本与可访问 HTML 交叉核验，未声称完成 PDF 页面视觉复核。两名实际审核者仍未签字，Gate 1 保持 `in_progress`。
+- 工程记录：读取限制登记为已解决的 `ERR-20260920-032`；解决指已找到可审计替代证据路径，不表示 PDF 端点恢复。
+- 推送状态：`pushed`；研究增量提交 `7d50ae6` 已推送至 `origin/main`，本地与远端 HEAD 核对一致。
+- 下一步：建立 GSHS 191 个组件中的主要结局题目版本与来源映射，保持 `_b_`、无前缀、二分类和频数型版本分离。
+
+### A-20260920-056：完成 GSHS 191 组件主要结局与表示关系审计
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取 `Document/research-workflow.md`、本进度档案并核对干净 Git 状态；流式扫描 GSHS 673,499 行；将 191 个已选组件与组件登记逐一核对；读取六个国家/地区的本地问卷、常规代码本和 Binary Codebook，并对 Ghana 关键 PDF 页做视觉复核。
+- 输入：`GSHS.csv`、`调查组件筛选明细.csv`、GSHS 数据字典；Ghana、India、Jamaica、Mongolia、Morocco、Wallis and Futuna 的国家/地区问卷与代码本。
+- 输出：新增 `audit_gshs_primary_outcome_components.py`、`gshs_primary_outcome_component_audit.json`、`gshs_primary_outcome_component_audit.md`；主要结局登记升级至 v1.2；更新 `.learnings/ERRORS.md`。
+- 检查：脚本通过 `py_compile`；JSON 可解析；191 个组件与登记完全一致，673,499 行全部覆盖，组件行数不一致为 0；仅 7 个组件有主要结局值，184 个没有；六个有结局组件具备本地直接来源，Solomon Islands 2023 尚缺；三组原始/`_b_` 关系均无异常组合。
+- 新证据：常规代码本中的 `MH_CONSIDERSUI`、`MH_PLANSUI`、`MH_ATTEMPTSUI` 是三项实际施测题；Binary Codebook 把 `MH_B_*` 定义为比例指标。逐行数据进一步确认意念和计划的 `_b_` 与原始二元编码完全相同，尝试的 `_b_` 精确按“0 次=否、1 次及以上=是”派生。因此 `_b_` 不再作为独立施测题计数；登记候选由 69 条降为 66 条，另有 11 条派生/非独立记录。
+- 质量边界：六个组件的文件语言只证明可用来源语言，不自动证明每名受访者的实际施测语言；Solomon Islands 直接来源、确切年龄/年级总体、规范缺失原因和两名实际审核者仍未完成。所有记录保持 `provisional`，Gate 1 仍为 `in_progress`。
+- 工程记录：重复的 pandas 全表内存耗尽改为固定列索引的流式扫描，记为已解决 `ERR-20260920-033`；项目环境未安装可选文档解析器和错误目录假设分别记为已解决 `ERR-20260920-034`、`ERR-20260920-035`，未把可选解析器无必要地加入正式建模环境。
+- 推送状态：`pushed`；研究增量提交 `f0a4538` 已推送至 `origin/main`。
+- 下一步：直接复核 YRBS 年度主要结局问卷/代码本，继续隔离 2021/2023 数据，并形成三套调查的回答编码与缺失规则草案。
+
+### A-20260920-057：完成 YRBS 年度主要结局直接来源审计并纠正列映射
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取工作流与进度档案并核对干净 Git 状态；逐年读取 1991–2023 共 17 份国家高中问卷和对应数据用户指南/代码本；分开登记“问卷印刷题号”与“发布数据变量号”；对 1991–2019 年度完整 Parquet 的正确列执行值域检查，并视觉复核 1995 与 2023 的代表性来源页。
+- 输入：`documentation/Questionnaire` 的 17 份官方问卷、`documentation/UserGuide` 的 17 份官方指南、15 个 1991–2019 年度 full Parquet、现有 `yrbs_selected_variable_dictionary.csv`。
+- 输出：新增 `audit_yrbs_primary_outcome_sources.py`、`yrbs_primary_outcome_source_audit.json`、`yrbs_primary_outcome_source_audit.md`；主要结局登记改用直接来源 crosswalk；更新 `.learnings/ERRORS.md`。
+- 检查：51 条主要结局记录均有问卷和数据指南来源；15 个可用年度的正确列均存在，观测编码全部落在官方值域；2021/2023 保持隔离；脚本和 JSON 校验通过。
+- 新证据：现有登记在 1995、2001、2003、2005、2007、2009、2011 共 7 年把 21 条主要结局映射到错误数据列。原因是把印刷问卷题号、数据用户指南变量号或自动提取结果混用；例如 1995 正确列为 `Q22/Q23/Q24`，旧登记却为 `Q30/Q31/Q32`。正确列仍存在于年度完整数据，因此属于 crosswalk 缺陷而非原始数据丢失。登记现已改为用户指南变量，并单独保留印刷题号。
+- 质量边界：年度指南只把无值统一报告为 Missing，未区分拒答、合法跳题或数据错误；不能无依据细分。问卷为英语来源，不自动证明所有语言便利措施。两名实际审核者仍未签字，Gate 1 保持 `in_progress`。
+- 工程记录：PDF 诊断文本首次受 Windows 控制台编码影响中止，改用 UTF-8 输出后完成，记为已解决 `ERR-20260920-036`；Poppler 字体警告未影响关键页视觉内容。
+- 推送状态：`pushed`；研究增量提交 `a7ac525` 已推送至 `origin/main`。
+- 下一步：建立三套调查主要结局的正式回答字典与保守缺失规则，生成双人审核队列；并定位 Solomon Islands 2023 GSHS 直接来源。
+
+### A-20260920-058：补齐 Solomon Islands 2023 GSHS 官方条目来源
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取工作流与进度档案并核对干净 Git 状态；检索 WHO NCD Microdata Repository 的 `SLB_2023_GSHS_v01` 研究页和三个逐题变量页；把官方目录证据纳入 GSHS 组件审计与主要结局登记。
+- 输入：WHO catalog 992 study metadata；变量 `V39`（意念）、`V40`（计划）、`V41`（尝试）；本地 Solomon Islands 1,995 行组件。
+- 输出：GSHS 组件审计升级至 v1.1，主要结局登记升级至 v1.4；所有七个有主要结局的 GSHS 组件现均有直接条目来源。
+- 检查：官方目录的三项 literal question、1/2 或 1–5 回答类别、有效/无效例数与本地组件逐项一致：意念 1,890/105、计划 1,953/42、尝试 1,963/32；研究页明确总体为 13–17 岁在校青少年、Form 1–6，并描述两阶段整群抽样。脚本重跑后直接条目来源为 7/7、待来源为 0。
+- 质量边界：未在官方 related-materials 中取得 2023 国家问卷文件，实际施测语言仍不能由英语目录元数据推断；因此语言字段保持 `provisional`。这不再是题文、编码或总体来源缺口。
+- 推送状态：`pushed`；研究增量提交 `e5e301e` 已推送至 `origin/main`。
+- 下一步：生成三套调查正式回答字典、保守缺失规则及双人审核队列；随后验证 YRBS 2021/2023 导入。
+
+### A-20260920-059：生成主要结局 Gate 1 结构化包与人工双审队列
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取 `Document/research-workflow.md`、本进度档案并核对干净 Git 状态；以 GSHS 组件审计、YRBS 年度直接来源审计和 NSDUH 主要结局登记为输入，生成可重复构建的正式题目层、回答字典、构念本体、设计登记、候选连接、来源冲突表和人工双审队列。
+- 输出：新增 `build_primary_outcome_package.py`、`item_bank.csv`、`response_dictionary.csv`、`survey_design.csv`、`construct_ontology.yaml`、`item_links.csv`、`source_conflicts.csv`、`primary_outcome_human_review_queue.csv`、`primary_outcome_package.md`；更新 `.learnings/ERRORS.md`。
+- 检查：脚本通过可重复构建及断言；84 个题目实例 ID 全部唯一（GSHS 21、YRBS 51、NSDUH 12），396 条回答编码覆盖全部题目，28 条调查/组件设计记录、9 条仅为候选的跨调查构念连接和 32 条来源冲突/证据缺口已生成；84 条双审队列逐项对应题库；所有 reviewer 字段为空、所有连接均为 `not_approved`，每题均有来源指针与总体说明。
+- 编码决策：GSHS/YRBS 尝试次数保留五级 `zero/one/two_or_three/four_or_five/six_or_more`，不在原始字典中静默二分；NSDUH 的“不确定”保留为观测类别，拒答、不知道、数据错误、空白和合法跳题分别保留为缺失类型；任何未知缺失均不得自动转为阴性。
+- 冲突登记：21 条 YRBS 旧映射作为已由直接来源解决的冲突保留审计轨迹；7 个 GSHS 组件的实际施测语言证据缺口和 4 个 NSDUH 尝试题的公用微数据访问缺口保持开放。
+- 设计边界：GSHS 使用规范化权重/PSU/stratum 候选字段；YRBS 2017/2019 设计字段缺口及 2021/2023 导入隔离被显式标记；NSDUH 的 `ANALWT2_C1`–`C4` 年度适用映射未凭猜测选择。所有设计记录仍为 provisional。
+- 工程记录：一次 NSDUH Parquet 字段名假设错误与一次 YRBS 尝试题响应形态假设错误均无数据改动，并分别记录为已解决的 `ERR-20260920-037`、`ERR-20260920-038`；后者由 fail-closed 检查在生成文件前中止，修正后重建通过。
+- 质量边界：本行动没有生成 `responses_long.parquet`，没有解除 YRBS 2021/2023 隔离，没有解决 NSDUH 尝试题的数据访问，也没有将 AI 检查登记为人工审核。Gate 1 保持 `in_progress`。
+- 推送状态：`pushed`；研究增量提交 `f7e0dbb` 已推送至 `origin/main`。
+- 下一步：按官方 SAS 程序与布局验证并导入 YRBS 2021/2023；随后从已通过来源和编码检查的可用年度生成 `responses_long.parquet`，并安排两名实际审核者处理队列。
+
+### A-20260920-060：按官方 SAS 布局导入并解除 YRBS 2021/2023 隔离
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前再次完整读取工作流与进度档案并核对干净 Git 状态；解析 CDC 官方 2021/2023 SAS Input 程序的定长字段位置，以源文件 SHA-256、逐行长度、主结局值域、设计字段完整性和 Parquet 往返读取作为解除隔离条件。
+- 输入：2021/2023 官方 SAS Input/Formats 程序、CDC 下载归档中的 `.dat`、本地 raw `.dat`、年度问卷与用户指南。
+- 输出：新增 `import_yrbs_2021_2023.py`、`yrbs_2021_2023_import_audit.json`、`yrbs_2021_2023_import_audit.md`；生成忽略于 Git 的 `yrbs_2021_full.parquet` 与 `yrbs_2023_full.parquet`；重建 YRBS 来源审计、主要结局登记和结构化包。
+- 检查：本地 raw 与 CDC 归档副本逐字节一致；两年每行均为 421 字节。2021 解析 17,232×239，2023 解析 20,103×252；两年 weight/stratum/PSU 均全量非空；Q26–Q28（2021）及 Q27–Q29（2023）观测值全部位于官方 1–2/1–5 值域；Parquet 写入后往返形状一致。YRBS 来源审计现为 17/17 年可用、隔离 0 年、值域失败 0。
+- 状态变更：仅解除“导入布局隔离”；题目仍为 `provisional`，不等于设计方差方法已批准或人类双审已完成。
+- 工程记录：SAS 标题注释中的 `Input` 误匹配和数值缺失符号 `.` 两个解析边界均在接受输出前失败关闭，修正并记录为 `ERR-20260920-039`。
+- 推送状态：`pushed`；研究增量提交 `a6df01d` 已推送至 `origin/main`。
+- 下一步：用当前题库/回答字典生成跨调查 `responses_long.parquet`，保留 eligibility、observed status 与各类缺失；同时准备实际双人审核安排。
+
+### A-20260920-061：生成并验证主要结局回答长表
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取工作流与进度档案并核对干净 Git 状态；以 `item_bank.csv` 和 `response_dictionary.csv` 为唯一映射源，流式处理 GSHS，读取 17 个 YRBS 年度完整表，并将 NSDUH 限定为官方 `CATAG2=1`（12–17 岁）青少年，生成 Gate 1 回答长表。
+- 输出：新增 `build_responses_long.py`、`responses_long_manifest.json`、`responses_long_audit.md`；生成忽略于 Git 的 `Dataset/可直接分析数据包_NSDUH_YRBS/harmonization/responses_long.parquet`。
+- 检查：输出 919,863 行且“受访者×题目”键 919,863 个，重复为 0；覆盖 80 个有本地回答数据的实例。按调查为 GSHS 64,599、YRBS 764,028、NSDUH 91,236 行，均与从 7 个 GSHS 组件、17 个 YRBS 年度表及 NSDUH 青少年人数独立推导的期望行数一致。867,995 行为有效观测；其余保留为 unknown、refused、dont_know、ordinary_missing 或 data_error；必填标识/状态无空值，所有有效观测均有 canonical response。
+- 纳入边界：GSHS 仅含 7 个实际施测组件；YRBS 含 17 个已验证年度；NSDUH 只含 12–17 岁青少年的意念和计划。4 个 `YUSUICTRY` 实例仍在题库但没有回答行，因为公用微数据未提供该字段，未从其他题推导或伪造。
+- 可复现性：输出 SHA-256 为 `0260386444fd2d4a9b0183ef79b171b4fa47ab1d7c1706b05619c14cc8f8a197`；生成物由脚本重建，不纳入 Git 大文件历史。
+- 工程记录：首次误用系统 Python 导致 DuckDB 不可用，在读取数据前失败；切换到锁定的 `.venv-research` 后完成，记录为已解决 `ERR-20260920-040`。
+- 质量边界：结构校验通过不等于条目内容双审或抽样设计批准。所有题目仍为 `provisional`，Gate 1 保持 `in_progress`。
+- 推送状态：`pushed`；研究提交 `89c20f3` 与认证失败状态提交 `9497d1c` 已在仅清除失效站点凭据并由 Git Credential Manager 重新授权后推送至 `origin/main`。
+- 下一步：逐调查核验权重、PSU、stratum 和方差方法的官方来源；随后落实两名实际审核者签署。
+
+### A-20260920-062：核验设计来源并修复 YRBS 2017/2019 设计字段
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取工作流、进度档案并检查 Git；复核 WHO GSHS 目录/方法页、17 份 CDC YRBS 年度指南及 SAMHSA NSDUH 公用数据指南；按官方定长位置恢复 YRBS 2017/2019 的 weight、stratum、PSU，并同步年度完整表及 1991–2019 selected 表。
+- 输出：新增 `repair_yrbs_2017_2019_design.py`、`yrbs_2017_2019_design_repair_audit.{json,md}`、`survey_design_source_audit.md`；更新 `survey_design.csv` 构建规则及入口结构审计。
+- 检查：2017 的 14,765 行和 2019 的 13,677 行三项设计字段均恢复为全量非空且权重为正；权重和分别为 14,765.0049 与 13,677.0071，与指南所述缩放到样本量一致。GSHS 七个主要结局组件共 21,533 人的 canonical/raw 权重、PSU、stratum 数值完全一致、全量非空且为正。NSDUH 232,441 行满足 `C2=C1/2`、`C3=C1/3`、`C4=C1/4` 精确等式，确认 C1 为单年权重、C2–C4 为合并 2–4 年的年均权重。
+- 方法决策：YRBS 使用 WEIGHT/STRATUM/PSU 的复杂抽样程序；NSDUH 使用 VESTR_C/VEREP、Taylor 线性化和单年 ANALWT2_C1，青少年分析必须作为全样本设计内的 domain 而非先物理删成人；GSHS 跨组件前为 PSU/stratum 增加组件命名空间。
+- 剩余例外：YRBS 1997 仍有 1 行同时缺三项设计字段，已显式登记，不能静默进入设计型方差估计。
+- 工程记录：PDF 工具路径不匹配在任何结论写入前失败，改用工作区 PDF runtime 后完成并记录为 `ERR-20260920-042`。
+- 推送状态：`pushed`；研究增量提交 `22d58f0` 已推送至 `origin/main`。
+- 下一步：由两名实际审核者独立处理 84 条主结局审核队列；完成签署与分歧裁决后执行 Gate 1 最终验收。
+
+### A-20260920-063：完成 Gate 1 契约补漏并生成独立人工审核包
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：行动前完整读取工作流、进度档案并核对干净 Git 状态；对 Gate 1 逐项做机器契约审计，修复题库 `text_hash`、回答字典 `page_or_section` 和设计表 `review_status` 三个缺失字段；生成两份相互独立的 84 行人工审核表、分歧裁决表、填写说明和 fail-closed 验证器。
+- 输出：新增 `build_human_review_packets.py`、`primary_outcome_review_reviewer_1.csv`、`primary_outcome_review_reviewer_2.csv`、`primary_outcome_review_adjudication.csv`、`human_review_instructions.md`、`validate_human_reviews.py`、`audit_gate1_acceptance.py`、`gate1_acceptance_audit.json`；重建 `item_bank.csv`、`response_dictionary.csv` 和 `survey_design.csv`。
+- 防伪边界：验证器要求两位不同姓名的实际人员、统一非空单位、ISO 日期、逐行六项 yes/no 核验、合法决定及完全一致的独立审核声明；任何非批准、修订或两人决定不一致均强制进入人工裁决。AI 不填写姓名、日期、决定或声明。
+- 检查：空白审核表各 84 个唯一题目；空白表验证按预期失败且 Gate 完成标记为 false。Gate 1 接受审计逐项验证七项交付物：84 行题库、396 行回答字典、28 行设计表、构念本体、919,863 行长表、9 条未批准候选连接及 32 条冲突记录均通过；唯一未满足项精确收敛为 `two_actual_human_reviewers`。
+- 状态：Gate 1 仍为 `in_progress`，不得因机器检查全部通过而绕过真实双人审核。
+- 推送状态：`pushed`；研究增量提交 `8f5cbc9` 已推送至 `origin/main`。
+- 下一步：将两份独立审核表交给两名不同实际审核者；返回后运行验证器、处理分歧、更新题库审核状态并执行最终 Gate 1 接受审计。
+
 ## 9. 剩余工作量估算（2026-09-20 基线）
 
 | 阶段 | 主要工作 | 预计人周 | 主要波动来源 |
@@ -714,6 +836,6 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 阶段 1 下一行动：
 
-1. 直接核验 NSDUH 2021–2024 青少年问卷/代码本中的 `YSUI03`–`YSUI05`，解释其与公开使用字段、跳题和可能抑制规则的关系；
+1. 由两名实际审核者独立处理 `primary_outcome_human_review_queue.csv`，核对题文、构念、总体、语言、编码、跳题和缺失规则；
-2. 建立 GSHS 组件级题目版本与官方问卷来源映射，保持 `_b_` 与无前缀版本分离；
+2. 对两位审核者的分歧执行显式裁决，不得由 AI 冒充审核者或自动填写签名；
-3. 随后形成回答编码/缺失规则草案，并把需要两名实际审核者处理的记录导出为审核队列。
+3. 审核通过后重建题库/回答层并执行 Gate 1 逐项验收；未签署前保持全部主要结局为 `provisional`。

research/stage1/audit_gate1_acceptance.py

@@ -0,0 +1,75 @@
+"""Requirement-by-requirement Gate 1 acceptance audit."""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE1 = ROOT / "research" / "stage1"
+
+
+def rows(name: str) -> list[dict[str, str]]:
+    with (STAGE1 / name).open(encoding="utf-8-sig", newline="") as handle:
+        return list(csv.DictReader(handle))
+
+
+def main() -> int:
+    checks = {}
+    unmet = []
+    items = rows("item_bank.csv")
+    item_required = {"item_version_id", "item_family_id", "source_variable", "question_text", "text_hash", "construct", "time_window", "response_type", "language", "survey_id", "component_id", "page_or_section", "review_status"}
+    item_fields = set(items[0]) if items else set()
+    item_ok = len(items) == 84 and len({r["item_version_id"] for r in items}) == 84 and item_required <= item_fields and all((r["source_file"] or r["source_url"]) and r["population"] for r in items) and all(r["text_hash"] == hashlib.sha256(r["question_text"].encode("utf-8")).hexdigest() for r in items)
+    checks["item_bank"] = {"passed": item_ok, "rows": len(items)}
+    if not item_ok: unmet.append("item_bank_contract")
+
+    dictionary = rows("response_dictionary.csv")
+    dictionary_required = {"item_version_id", "raw_code", "raw_label", "canonical_code", "missing_type", "derivation_rule", "source_file", "source_url", "page_or_section", "review_status"}
+    dictionary_ok = len(dictionary) == 396 and dictionary_required <= set(dictionary[0]) and {r["item_version_id"] for r in dictionary} == {r["item_version_id"] for r in items}
+    checks["response_dictionary"] = {"passed": dictionary_ok, "rows": len(dictionary)}
+    if not dictionary_ok: unmet.append("response_dictionary_contract")
+
+    designs = rows("survey_design.csv")
+    design_required = {"survey_id", "component_id", "weight_field", "psu_field", "stratum_field", "variance_method", "design_source", "review_status"}
+    design_ok = len(designs) == 28 and len({(r["survey_id"], r["component_id"]) for r in designs}) == 28 and design_required <= set(designs[0]) and all(all(r[k] for k in design_required) for r in designs)
+    checks["survey_design"] = {"passed": design_ok, "rows": len(designs)}
+    if not design_ok: unmet.append("survey_design_contract")
+
+    ontology_ok = (STAGE1 / "construct_ontology.yaml").exists()
+    checks["construct_ontology"] = {"passed": ontology_ok}
+    if not ontology_ok: unmet.append("construct_ontology_missing")
+
+    manifest = json.loads((STAGE1 / "responses_long_manifest.json").read_text(encoding="utf-8"))
+    output = ROOT / manifest["output_file"]
+    response_ok = output.exists() and manifest["rows"] == manifest["unique_response_keys"] == 919863 and manifest["item_instances_with_rows"] == 80
+    checks["responses_long"] = {"passed": response_ok, "rows": manifest["rows"], "items_with_rows": manifest["item_instances_with_rows"]}
+    if not response_ok: unmet.append("responses_long_contract")
+
+    links = rows("item_links.csv")
+    links_ok = bool(links) and all(r["anchor_status"] == "not_approved" for r in links)
+    checks["item_links"] = {"passed": links_ok, "rows": len(links), "approved_anchors": sum(r["anchor_status"] != "not_approved" for r in links)}
+    if not links_ok: unmet.append("item_links_contract")
+
+    conflicts = rows("source_conflicts.csv")
+    conflicts_ok = bool(conflicts) and all(r["status"] for r in conflicts)
+    checks["source_conflicts"] = {"passed": conflicts_ok, "rows": len(conflicts), "open": sum(r["status"].startswith("open") for r in conflicts)}
+    if not conflicts_ok: unmet.append("source_conflicts_contract")
+
+    human_path = STAGE1 / "human_review_validation.json"
+    human = json.loads(human_path.read_text(encoding="utf-8")) if human_path.exists() else {}
+    human_ok = human.get("status") == "passed" and human.get("gate_1_human_review_complete") is True and human.get("reviewer_1") and human.get("reviewer_2") and human.get("reviewer_1") != human.get("reviewer_2")
+    checks["two_actual_human_reviewers"] = {"passed": bool(human_ok), "evidence_file": str(human_path.relative_to(ROOT)).replace("\\", "/") if human_path.exists() else None}
+    if not human_ok: unmet.append("two_actual_human_reviewers")
+
+    result = {"gate": 1, "status": "passed" if not unmet else "in_progress", "checks": checks, "unmet_requirements": unmet}
+    (STAGE1 / "gate1_acceptance_audit.json").write_text(json.dumps(result, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+    return 0 if not unmet else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

research/stage1/audit_gshs_primary_outcome_components.py

@@ -0,0 +1,424 @@
+"""Audit GSHS primary-outcome coverage across all selected components.
+
+The audit is deliberately conservative. It verifies observed column relations and
+records local questionnaire/codebook provenance, but it does not approve item
+equivalence, missing-value recodes, population scope, or human review.
+"""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from collections import Counter, defaultdict
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE_DIR = ROOT / "research" / "stage1"
+GSHS_ROOT = ROOT / "Dataset" / "GSHS-全球学生健康调查数据" / "GSHS"
+DATA = GSHS_ROOT / "01_data" / "GSHS.csv"
+COMPONENTS = GSHS_ROOT / "02_documentation" / "调查组件筛选明细.csv"
+QUESTIONNAIRES = GSHS_ROOT / "Questionnaire" / "GSHS Per Country"
+OUT_JSON = STAGE_DIR / "gshs_primary_outcome_component_audit.json"
+OUT_MD = STAGE_DIR / "gshs_primary_outcome_component_audit.md"
+
+RAW_VARIABLES = {
+    "raw_mh_considersui": {
+        "construct": "suicide_ideation",
+        "question_text": "During the past 12 months, did you seriously consider attempting suicide?",
+        "response_type": "binary",
+        "codes": {"1": "Yes", "2": "No"},
+    },
+    "raw_mh_plansui": {
+        "construct": "suicide_plan",
+        "question_text": "During the past 12 months, did you make a plan about how you would attempt suicide?",
+        "response_type": "binary",
+        "codes": {"1": "Yes", "2": "No"},
+    },
+    "raw_mh_attemptsui": {
+        "construct": "suicide_attempt",
+        "question_text": "During the past 12 months, how many times did you attempt suicide?",
+        "response_type": "ordinal_frequency",
+        "codes": {
+            "1": "0 times",
+            "2": "1 time",
+            "3": "2 or 3 times",
+            "4": "4 or 5 times",
+            "5": "6 or more times",
+        },
+    },
+}
+
+DERIVED_VARIABLES = {
+    "raw_mh_b_considersui": {
+        "construct": "suicide_ideation",
+        "source_variable": "raw_mh_considersui",
+        "response_type": "binary_derived_or_duplicate",
+        "codes": {"1": "Yes", "2": "No"},
+        "expected_rule": {"1": "1", "2": "2"},
+    },
+    "raw_mh_b_plansui": {
+        "construct": "suicide_plan",
+        "source_variable": "raw_mh_plansui",
+        "response_type": "binary_derived_or_duplicate",
+        "codes": {"1": "Yes", "2": "No"},
+        "expected_rule": {"1": "1", "2": "2"},
+    },
+    "raw_mh_b_attemptsui": {
+        "construct": "suicide_attempt",
+        "source_variable": "raw_mh_attemptsui",
+        "response_type": "binary_derived",
+        "codes": {"1": "Yes", "2": "No"},
+        "expected_rule": {"1": "2", "2": "1", "3": "1", "4": "1", "5": "1"},
+    },
+}
+
+ALL_VARIABLES = list(RAW_VARIABLES) + list(DERIVED_VARIABLES)
+
+SOURCE_PACKAGES = {
+    "GHA_2022_GSHS_v01::gha_sek_tak2022": {
+        "question_numbers": {"ideation": "Q33", "plan": "Q34", "attempt": "Q35"},
+        "documents": [
+            ("Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf", "questionnaire", "page 6"),
+            ("Ghana 2022/2022_Ghana_(Sekondi-Takoradi)_Codebook.pdf", "raw codebook", "pages 7-8"),
+            ("Ghana 2022/2022_Ghana_(Sekondi-Takoradi)_Binary_Codebook.pdf", "binary codebook", "pages 7-8"),
+        ],
+        "source_language_evidence": ["English"],
+    },
+    "IND_2022_GSHS_v01::ind_jaipur_2022": {
+        "question_numbers": {"ideation": "Q34", "plan": "Q35", "attempt": "Q36"},
+        "documents": [
+            ("India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx", "questionnaire", "Q34-Q36"),
+            ("India 2022/2022_India_(Jaipur)_Codebook.docx", "raw codebook", "MH_CONSIDERSUI through MH_ATTEMPTSUI"),
+            ("India 2022/2022_India_(Jaipur)_Binary_Codebook.docx", "binary codebook", "MH_B_CONSIDERSUI through MH_B_ATTEMPTSUI"),
+        ],
+        "source_language_evidence": ["English"],
+    },
+    "JAM_2023_GSHS_v01::jam_st_cath_2023": {
+        "question_numbers": {"ideation": "Q28", "plan": "Q29", "attempt": "Q30"},
+        "documents": [
+            ("Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx", "questionnaire", "Q28-Q30"),
+            ("Jamaica 2023/2023_Jamaica_(St_Catherine)_Codebook.docx", "raw codebook", "MH_CONSIDERSUI through MH_ATTEMPTSUI"),
+            ("Jamaica 2023/2023_Jamaica_(St_Catherine)_Binary_Codebook.docx", "binary codebook", "MH_B_CONSIDERSUI through MH_B_ATTEMPTSUI"),
+        ],
+        "source_language_evidence": ["English"],
+    },
+    "MNG_2023_GSHS_v01::mng2023": {
+        "question_numbers": {"ideation": "Q36", "plan": "Q37", "attempt": "Q38"},
+        "documents": [
+            ("Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx", "English questionnaire", "Q36-Q38"),
+            ("Mongolia 2023/Mongolia-GSHS-Questionnaire-MONGOLIAN.docx", "Mongolian questionnaire", "Q36-Q38"),
+            ("Mongolia 2023/2023 Mongolia Codebook.docx", "raw codebook", "MH_CONSIDERSUI through MH_ATTEMPTSUI"),
+            ("Mongolia 2023/2023 Mongolia Binary_Codebook.docx", "binary codebook", "MH_B_CONSIDERSUI through MH_B_ATTEMPTSUI"),
+        ],
+        "source_language_evidence": ["English", "Mongolian"],
+    },
+    "2023_MAR_GSHS_v01::mar_fez2023": {
+        "question_numbers": {"ideation": "Q32", "plan": "Q33", "attempt": "Q34"},
+        "documents": [
+            ("Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf", "French questionnaire", "page 6"),
+            ("Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_ENGLISH.pdf", "English questionnaire", "page 6"),
+            ("Morocco 2023/2023_Maroc_(Fes)_Codebook.pdf", "raw codebook", "pages 7-8"),
+            ("Morocco 2023/2023_Maroc_(Fes)_Binary_Codebook.pdf", "binary codebook", "pages 7-8"),
+        ],
+        "source_language_evidence": ["French", "English reference"],
+    },
+    "WLF_2023_GSHS_v01::wlf_2023": {
+        "question_numbers": {"ideation": "Q29", "plan": "Q30", "attempt": "Q31"},
+        "documents": [
+            ("Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx", "French questionnaire", "Q29-Q31"),
+            ("Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - English.docx", "English questionnaire", "Q29-Q31"),
+            ("Wallis and Futuna 2023/2023 Wallis and Futuna Codebook.docx", "raw codebook", "MH_CONSIDERSUI through MH_ATTEMPTSUI"),
+            ("Wallis and Futuna 2023/2023 Wallis and Futuna Binary_Codebook.docx", "binary codebook", "MH_B_CONSIDERSUI through MH_B_ATTEMPTSUI"),
+        ],
+        "source_language_evidence": ["French", "English reference"],
+    },
+}
+
+SOLOMON_COMPONENT = "SLB_2023_GSHS_v01::slb_2023"
+SOLOMON_CATALOG_SOURCES = [
+    ("https://extranet.who.int/ncdsmicrodata/index.php/catalog/992/variable/V39", "ideation variable metadata"),
+    ("https://extranet.who.int/ncdsmicrodata/index.php/catalog/992/variable/V40", "plan variable metadata"),
+    ("https://extranet.who.int/ncdsmicrodata/index.php/catalog/992/variable/V41", "attempt variable metadata"),
+    ("https://extranet.who.int/ncdsmicrodata/index.php/catalog/992", "study universe and sampling metadata"),
+]
+
+
+def sha256(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def read_component_metadata() -> dict[str, dict]:
+    with COMPONENTS.open(encoding="utf-8-sig", newline="") as handle:
+        rows = list(csv.DictReader(handle))
+    selected = {row["dataset_id"]: row for row in rows if row["include_in_master"] == "1"}
+    if len(selected) != 191:
+        raise AssertionError(f"Expected 191 selected components, found {len(selected)}")
+    return selected
+
+
+def scan_data() -> dict:
+    row_counts: Counter[str] = Counter()
+    nonmissing: dict[str, Counter[str]] = defaultdict(Counter)
+    values: dict[str, dict[str, Counter[str]]] = defaultdict(lambda: defaultdict(Counter))
+    pairs: dict[str, Counter[tuple[str, str]]] = defaultdict(Counter)
+
+    with DATA.open(encoding="utf-8-sig", newline="") as handle:
+        reader = csv.reader(handle)
+        header = next(reader)
+        indices = {name: header.index(name) for name in ["dataset_id", *ALL_VARIABLES]}
+        for row in reader:
+            component = row[indices["dataset_id"]]
+            row_counts[component] += 1
+            observed = {name: row[indices[name]].strip() for name in ALL_VARIABLES}
+            for name, value in observed.items():
+                if value:
+                    nonmissing[component][name] += 1
+                    values[component][name][value] += 1
+            for derived, spec in DERIVED_VARIABLES.items():
+                source = spec["source_variable"]
+                pairs[derived][(observed[source], observed[derived])] += 1
+
+    return {
+        "row_counts": row_counts,
+        "nonmissing": nonmissing,
+        "values": values,
+        "pairs": pairs,
+    }
+
+
+def source_package(component_id: str) -> dict:
+    package = SOURCE_PACKAGES.get(component_id)
+    if package is None:
+        if component_id == SOLOMON_COMPONENT:
+            return {
+                "status": "official_catalog_item_metadata_verified",
+                "documents": [
+                    {"source_url": url, "role": role, "page_or_section": "WHO NCD Microdata Repository catalog"}
+                    for url, role in SOLOMON_CATALOG_SOURCES
+                ],
+                "question_numbers": None,
+                "source_language_evidence": ["English catalog literal-question metadata"],
+                "note": "The official catalog provides literal questions, response categories, case counts, universe, and sampling metadata. A country questionnaire file and actual administration-language evidence were not located.",
+            }
+        return {
+            "status": "pending_local_direct_source",
+            "documents": [],
+            "question_numbers": None,
+            "source_language_evidence": [],
+            "note": "No country questionnaire or codebook for this component was found in the local source package.",
+        }
+    documents = []
+    for relative, role, section in package["documents"]:
+        path = QUESTIONNAIRES / relative
+        if not path.exists():
+            raise FileNotFoundError(path)
+        documents.append(
+            {
+                "source_file": str(path.relative_to(ROOT)).replace("\\", "/"),
+                "role": role,
+                "page_or_section": section,
+                "sha256": sha256(path),
+            }
+        )
+    return {
+        "status": "local_questionnaire_and_codebooks_located",
+        "documents": documents,
+        "question_numbers": package["question_numbers"],
+        "source_language_evidence": package["source_language_evidence"],
+        "note": "Available-language documents do not by themselves prove the language actually administered to every respondent.",
+    }
+
+
+def serial_counter(counter: Counter) -> dict:
+    return {str(key): value for key, value in sorted(counter.items(), key=lambda item: str(item[0]))}
+
+
+def build_audit() -> dict:
+    metadata = read_component_metadata()
+    scan = scan_data()
+    data_components = set(scan["row_counts"])
+    if data_components != set(metadata):
+        raise AssertionError("GSHS.csv component IDs do not match the 191 selected metadata rows")
+
+    components = []
+    row_count_mismatches = []
+    for component_id, meta in sorted(metadata.items()):
+        expected_rows = int(meta["row_count"])
+        observed_rows = scan["row_counts"][component_id]
+        if expected_rows != observed_rows:
+            row_count_mismatches.append(
+                {"component_id": component_id, "metadata_rows": expected_rows, "observed_rows": observed_rows}
+            )
+        variable_counts = {
+            name: {
+                "nonmissing": scan["nonmissing"][component_id][name],
+                "value_counts": serial_counter(scan["values"][component_id][name]),
+            }
+            for name in ALL_VARIABLES
+        }
+        has_primary = any(item["nonmissing"] for item in variable_counts.values())
+        components.append(
+            {
+                "component_id": component_id,
+                "reference_id": meta["reference_id"],
+                "catalog_id": meta["catalog_id"],
+                "country": meta["country"],
+                "iso3": meta["iso3"] or None,
+                "collection_start": meta["collection_start"],
+                "survey_component": meta["survey_component"],
+                "survey_scope": meta["survey_scope"],
+                "population": (
+                    "school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible"
+                    if component_id == SOLOMON_COMPONENT
+                    else "school-attending students; exact sampled ages/grades remain pending component source review"
+                ),
+                "observed_rows": observed_rows,
+                "canonical_relative_path": meta["canonical_relative_path"],
+                "catalog_url": meta["catalog_url"],
+                "primary_outcomes_observed": has_primary,
+                "variables": variable_counts,
+                "source_package": source_package(component_id) if has_primary else None,
+                "review_status": "provisional",
+                "reviewer_1": None,
+                "reviewer_2": None,
+            }
+        )
+
+    relation_checks = []
+    for derived, spec in DERIVED_VARIABLES.items():
+        observed_pairs = scan["pairs"][derived]
+        unexpected = []
+        for (raw, binary), count in observed_pairs.items():
+            expected = "" if raw == "" else spec["expected_rule"].get(raw)
+            if binary != expected:
+                unexpected.append({"raw": raw or None, "derived": binary or None, "count": count})
+        relation_checks.append(
+            {
+                "source_variable": spec["source_variable"],
+                "derived_variable": derived,
+                "expected_rule": spec["expected_rule"],
+                "observed_pair_counts": {
+                    f"{raw or '<missing>'}->{binary or '<missing>'}": count
+                    for (raw, binary), count in sorted(observed_pairs.items())
+                },
+                "unexpected_pairs": unexpected,
+                "check_status": "passed" if not unexpected else "failed",
+            }
+        )
+
+    available = [component for component in components if component["primary_outcomes_observed"]]
+    local_sources = [component for component in available if component["source_package"]["status"] == "local_questionnaire_and_codebooks_located"]
+    direct_sources = [component for component in available if component["source_package"]["status"] != "pending_local_direct_source"]
+    return {
+        "schema_version": "1.1",
+        "generated_on": "2026-09-20",
+        "status": "provisional",
+        "purpose": "Gate 1 component-level coverage and provenance audit for GSHS suicide ideation, plan, and attempt.",
+        "inputs": {
+            "data_file": str(DATA.relative_to(ROOT)).replace("\\", "/"),
+            "data_sha256": sha256(DATA),
+            "component_registry": str(COMPONENTS.relative_to(ROOT)).replace("\\", "/"),
+            "component_registry_sha256": sha256(COMPONENTS),
+        },
+        "summary": {
+            "selected_components": len(components),
+            "components_with_primary_outcomes": len(available),
+            "components_without_primary_outcomes": len(components) - len(available),
+            "components_with_direct_item_sources": len(direct_sources),
+            "components_with_local_direct_sources": len(local_sources),
+            "components_with_local_questionnaire_packages": len(local_sources),
+            "components_with_official_catalog_only": len(direct_sources) - len(local_sources),
+            "components_pending_direct_item_source": len(available) - len(direct_sources),
+            "observed_rows": sum(scan["row_counts"].values()),
+            "row_count_mismatches": len(row_count_mismatches),
+        },
+        "item_definitions": {
+            "administered_raw_items": RAW_VARIABLES,
+            "derived_or_duplicate_representations": DERIVED_VARIABLES,
+            "missing_rule_status": "unresolved; blank values are retained as missing and are not yet assigned a canonical missing type",
+        },
+        "relation_checks": relation_checks,
+        "row_count_mismatches": row_count_mismatches,
+        "components": components,
+        "review_boundary": {
+            "human_reviewers_required": 2,
+            "ai_review_is_human_review": False,
+            "population_scope_approved": False,
+            "missing_rules_approved": False,
+            "cross_component_equivalence_approved": False,
+            "confirmatory_analysis_allowed": False,
+        },
+    }
+
+
+def render_markdown(audit: dict) -> str:
+    available = [c for c in audit["components"] if c["primary_outcomes_observed"]]
+    lines = [
+        "# GSHS primary-outcome component audit",
+        "",
+        "Version: 1.0 | Status: provisional | Generated: 2026-09-20",
+        "",
+        "## Result",
+        "",
+        f"The selected GSHS master table contains {audit['summary']['selected_components']} components and {audit['summary']['observed_rows']:,} rows. Exactly {audit['summary']['components_with_primary_outcomes']} components contain the three primary suicide outcomes; the remaining {audit['summary']['components_without_primary_outcomes']} contain no observed values in those six columns. Metadata row counts match the consolidated table for all components.",
+        "",
+        "The country questionnaires and ordinary codebooks identify three administered items: past-12-month suicide ideation, plan, and attempt frequency. The Binary Codebooks identify the `_b_` columns as binary indicators derived from those items. Row-level checks are exact: ideation and plan binary columns duplicate the raw yes/no coding, while attempt maps 0 times to No and one or more times to Yes. Therefore the `_b_` columns must not be counted as independent administered items.",
+        "",
+        "## Components with observed primary outcomes",
+        "",
+        "| Component | Country | Rows | Ideation nonmissing | Plan nonmissing | Attempt nonmissing | Direct local sources |",
+        "|---|---|---:|---:|---:|---:|---|",
+    ]
+    for component in available:
+        variables = component["variables"]
+        source = component["source_package"]["status"]
+        lines.append(
+            f"| `{component['component_id']}` | {component['country']} | {component['observed_rows']:,} | {variables['raw_mh_considersui']['nonmissing']:,} | {variables['raw_mh_plansui']['nonmissing']:,} | {variables['raw_mh_attemptsui']['nonmissing']:,} | {source} |"
+        )
+    lines += [
+        "",
+        "## Representation checks",
+        "",
+        "| Raw item | Binary representation | Result | Observed mapping |",
+        "|---|---|---|---|",
+    ]
+    for check in audit["relation_checks"]:
+        mapping = "; ".join(f"{key}: {value:,}" for key, value in check["observed_pair_counts"].items())
+        lines.append(
+            f"| `{check['source_variable']}` | `{check['derived_variable']}` | {check['check_status']} | {mapping} |"
+        )
+    lines += [
+        "",
+        "## Source boundary",
+        "",
+        f"Local questionnaires plus raw and binary codebooks were located for {audit['summary']['components_with_local_questionnaire_packages']} components: Ghana, India, Jamaica, Mongolia, Morocco, and Wallis and Futuna. For Solomon Islands, the official WHO catalog directly provides the three literal questions, response categories, case counts, universe, and sampling metadata. A country questionnaire file and administration-language evidence were not located, so those narrower provenance fields remain pending.",
+        "",
+        "Available English/French/Mongolian files establish wording evidence but do not by themselves prove the language administered to every respondent. Exact sampled ages/grades, component-specific eligibility, and canonical missing reasons also remain unresolved.",
+        "",
+        "## Gate 1 decision",
+        "",
+        "Gate 1 remains **in progress**. This audit resolves the 191-component coverage question, direct item-source coverage, and the raw-versus-`_b_` representation issue, but it does not satisfy all population/language/missing-rule or two-human-reviewer requirements. All records remain provisional and are not approved for confirmatory analysis or anchor construction.",
+        "",
+        "## Reproduction",
+        "",
+        "Run `research/stage1/audit_gshs_primary_outcome_components.py` in the project Python environment. The implementation streams the consolidated CSV and does not load it into pandas memory.",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def main() -> None:
+    audit = build_audit()
+    OUT_JSON.write_text(json.dumps(audit, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    OUT_MD.write_text(render_markdown(audit), encoding="utf-8")
+    print(json.dumps(audit["summary"], ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/audit_input_sources.py

@@ -166,9 +166,10 @@ def build_audit() -> dict[str, Any]:
             ),
         },
         "limitations": [
-            "YRBS 2021 and 2023 are not included in the selected analytic Parquet and remain quarantined pending layout verification.",
+            "YRBS 2021 and 2023 have validated annual full Parquet files but are not appended to the legacy 1991-2019 selected table.",
-            "GSHS design fields are candidates and require survey-specific source verification.",
+            "One YRBS 1997 record lacks weight, stratum, and PSU; 2017/2019 design fields were restored from official fixed-width locations.",
-            "NSDUH year-specific weight selection and variance usage require confirmation against the combined-file guide.",
+            "GSHS design-field identities are verified for the seven primary-outcome components; cross-component identifiers require namespacing.",
+            "NSDUH uses ANALWT2_C1 for single-year estimates; C2/C3/C4 are exact 2/3/4-year pooled annual-average weights. Domain variance analysis must retain the full design.",
             "This audit does not approve item wording, response recodes, missingness rules, constructs, or cross-survey links."
         ]
     }

research/stage1/audit_yrbs_primary_outcome_sources.py

@@ -0,0 +1,253 @@
+"""Cross-check YRBS primary outcomes against annual questionnaires and user guides."""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from collections import Counter
+from pathlib import Path
+
+import pyarrow.parquet as pq
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE_DIR = ROOT / "research" / "stage1"
+YRBS_ROOT = ROOT / "Dataset" / "YRBS_National_1991_2023"
+PACKAGE = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "YRBS"
+DICTIONARY = PACKAGE / "yrbs_selected_variable_dictionary.csv"
+OUT_JSON = STAGE_DIR / "yrbs_primary_outcome_source_audit.json"
+OUT_MD = STAGE_DIR / "yrbs_primary_outcome_source_audit.md"
+
+CONSTRUCTS = ["suicide_ideation", "suicide_plan", "suicide_attempt"]
+QUESTION_TEXT = {
+    "suicide_ideation": "During the past 12 months, did you ever seriously consider attempting suicide?",
+    "suicide_plan": "During the past 12 months, did you make a plan about how you would attempt suicide?",
+    "suicide_attempt": "During the past 12 months, how many times did you actually attempt suicide?",
+}
+OPTIONS = {
+    "suicide_ideation": {"1": "Yes", "2": "No"},
+    "suicide_plan": {"1": "Yes", "2": "No"},
+    "suicide_attempt": {
+        "1": "0 times",
+        "2": "1 time",
+        "3": "2 or 3 times",
+        "4": "4 or 5 times",
+        "5": "6 or more times",
+    },
+}
+
+# Data-variable numbers come from the annual user guides/codebooks. Printed
+# questionnaire numbers are retained separately because the two differ in some
+# years and are not interchangeable.
+YEAR_SOURCES = {
+    1991: (19, 19, "1991_hs_questionnaire.pdf", "page 5", "YRBS_1991_National_User_Guide.pdf", "page 9"),
+    1993: (24, 23, "1993_xxh_questionnaire.pdf", "page 6", "YRBS_1993_National_User_Guide.pdf", "page 11"),
+    1995: (22, 22, "1995_xxh_questionnaire.pdf", "page 6", "YRBS_1995_National_User_Guide.pdf", "pages 11-12"),
+    1997: (22, 21, "1997_xxh_questionnaire.pdf", "page 6", "YRBS_1997_National_User_Guide.pdf", "pages 11-12"),
+    1999: (23, 23, "1999_xxh_questionnaire.pdf", "page 7", "YRBS_1999_National_User_Guide.pdf", "page 7"),
+    2001: (24, 25, "2001_xxh_questionnaire.pdf", "page 7", "YRBS_2001_National_User_Guide.pdf", "pages 8-9"),
+    2003: (24, 25, "2003_xxh_questionnaire.pdf", "page 7", "YRBS_2003_National_User_Guide.pdf", "pages 9-10"),
+    2005: (24, 26, "2005_xxh_questionnaire.pdf", "page 7", "YRBS_2005_National_User_Guide.pdf", "pages 16-17"),
+    2007: (24, 25, "2007_xxh_questionnaire.pdf", "page 7", "YRBS_2007_National_User_Guide.pdf", "page 20"),
+    2009: (24, 25, "2009_xxh_questionnaire.pdf", "page 7", "YRBS_2009_National_User_Guide.pdf", "page 22"),
+    2011: (25, 27, "2011_xxh_questionnaire.pdf", "pages 7-8", "YRBS_2011_National_User_Guide.pdf", "page 20"),
+    2013: (27, 27, "2013_xxh_questionnaire.pdf", "page 8", "YRBS_2013_National_User_Guide.pdf", "page 28"),
+    2015: (27, 27, "2015_xxh_questionnaire.pdf", "pages 7-8", "2015_yrbs-data-users_guide_smy_combined.pdf", "page 29"),
+    2017: (26, 27, "2017_yrbs_national_hs_questionnaire.pdf", "page 8", "2017_YRBS_Data_Users_Guide.pdf", "page 29"),
+    2019: (26, 26, "2019_YRBS-National-HS-Questionnaire.pdf", "page 8", "2019_National_YRBS_Data_Users_Guide.pdf", "pages 27-28"),
+    2021: (26, 26, "2021-YRBS-National-HS-Questionnaire.pdf", "page 8", "2021_YRBS_Data_Users_Guide_508.pdf", "page 28"),
+    2023: (27, 31, "2023_YRBS_National_HS_Questionnaire.pdf", "page 9", "2023_National_YRBS_Data_Users_Guide508.pdf", "page 29"),
+}
+
+
+def sha256(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def dictionary_rows() -> dict[tuple[int, str], dict]:
+    with DICTIONARY.open(encoding="utf-8-sig", newline="") as handle:
+        rows = list(csv.DictReader(handle))
+    selected = {
+        (int(row["year"]), row["construct"]): row
+        for row in rows
+        if row["construct"] in CONSTRUCTS
+    }
+    if len(selected) != 51:
+        raise AssertionError(f"Expected 51 existing primary-outcome dictionary rows, found {len(selected)}")
+    return selected
+
+
+def value_counts(path: Path, variable: str) -> dict:
+    table = pq.read_table(path, columns=[variable])
+    values = table.column(variable).to_pylist()
+    counts = Counter("<missing>" if value is None or str(value).strip() == "" else str(value) for value in values)
+    return {key: counts[key] for key in sorted(counts)}
+
+
+def build_audit() -> dict:
+    existing = dictionary_rows()
+    items = []
+    source_files: dict[str, dict] = {}
+    mismatch_years = set()
+    questionnaire_data_number_differences = set()
+
+    for year, (data_start, questionnaire_start, q_name, q_section, g_name, g_section) in YEAR_SOURCES.items():
+        questionnaire = YRBS_ROOT / "documentation" / "Questionnaire" / q_name
+        guide = YRBS_ROOT / "documentation" / "UserGuide" / g_name
+        for path, role in [(questionnaire, "questionnaire"), (guide, "data_user_guide")]:
+            if not path.exists():
+                raise FileNotFoundError(path)
+            relative = str(path.relative_to(ROOT)).replace("\\", "/")
+            source_files.setdefault(relative, {"role": role, "sha256": sha256(path)})
+
+        full_path = PACKAGE / "full_by_year" / f"yrbs_{year}_full.parquet"
+        full_schema = set(pq.ParquetFile(full_path).schema_arrow.names) if full_path.exists() else set()
+        for offset, construct in enumerate(CONSTRUCTS):
+            official_variable = f"q{data_start + offset}"
+            questionnaire_number = questionnaire_start + offset
+            old = existing[(year, construct)]
+            old_variable = old["variable"].lower()
+            mapping_matches = old_variable == official_variable
+            if not mapping_matches:
+                mismatch_years.add(year)
+            if data_start != questionnaire_start:
+                questionnaire_data_number_differences.add(year)
+
+            if full_path.exists():
+                if official_variable not in full_schema:
+                    raise AssertionError(f"{year} full table lacks {official_variable}")
+                official_counts = value_counts(full_path, official_variable)
+                previous_counts = value_counts(full_path, old_variable) if old_variable in full_schema else None
+                observed_codes = {key for key in official_counts if key != "<missing>"}
+                expected_codes = set(OPTIONS[construct])
+                code_domain_status = "passed" if observed_codes <= expected_codes else "failed"
+                data_status = "available_full_table"
+            else:
+                official_counts = None
+                previous_counts = None
+                code_domain_status = "not_tested_missing_import"
+                data_status = "missing_import"
+
+            items.append(
+                {
+                    "survey": "YRBS",
+                    "year": year,
+                    "construct": construct,
+                    "source_variable": official_variable.upper(),
+                    "previous_registry_variable": old["variable"],
+                    "mapping_status": "verified" if mapping_matches else "corrected_from_previous_registry",
+                    "questionnaire_question_number": questionnaire_number,
+                    "data_user_guide_variable_number": data_start + offset,
+                    "question_text": QUESTION_TEXT[construct],
+                    "time_window": "past 12 months",
+                    "response_type": "binary" if construct != "suicide_attempt" else "ordinal_frequency",
+                    "answer_options": OPTIONS[construct],
+                    "population": "students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review",
+                    "language": "English questionnaire source; actual accommodation/language coverage not established by this audit",
+                    "questionnaire_source_file": str(questionnaire.relative_to(ROOT)).replace("\\", "/"),
+                    "questionnaire_page_or_section": q_section,
+                    "data_guide_source_file": str(guide.relative_to(ROOT)).replace("\\", "/"),
+                    "data_guide_page_or_section": g_section,
+                    "data_status": data_status,
+                    "official_value_counts": official_counts,
+                    "previous_mapped_value_counts": previous_counts if not mapping_matches else official_counts,
+                    "code_domain_status": code_domain_status,
+                    "missing_rule_status": "blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason",
+                    "review_status": "provisional",
+                    "reviewer_1": None,
+                    "reviewer_2": None,
+                }
+            )
+
+    return {
+        "schema_version": "1.0",
+        "generated_on": "2026-09-20",
+        "status": "provisional",
+        "purpose": "Gate 1 direct-source audit and question-number/data-variable crosswalk for YRBS primary outcomes.",
+        "inputs": {
+            "previous_dictionary": str(DICTIONARY.relative_to(ROOT)).replace("\\", "/"),
+            "previous_dictionary_sha256": sha256(DICTIONARY),
+            "source_files": source_files,
+        },
+        "summary": {
+            "years_reviewed": 17,
+            "items_reviewed": len(items),
+            "years_available_in_full_tables": len({item["year"] for item in items if item["data_status"] == "available_full_table"}),
+            "years_quarantined": len({item["year"] for item in items if item["data_status"] != "available_full_table"}),
+            "previous_mapping_mismatch_years": sorted(mismatch_years),
+            "previous_mapping_mismatch_items": sum(item["mapping_status"] != "verified" for item in items),
+            "questionnaire_data_number_difference_years": sorted(questionnaire_data_number_differences),
+            "code_domain_failures": sum(item["code_domain_status"] == "failed" for item in items),
+        },
+        "items": items,
+        "decision": {
+            "registry_action": "replace prior YRBS primary-outcome variable mappings with this direct-source crosswalk",
+            "data_action": "use verified data-user-guide variables from annual full tables; do not infer data columns from printed questionnaire numbers",
+            "quarantine": "2021 and 2023 released from layout quarantine after independent official-SAS import validation; item review remains provisional",
+            "gate_1": "in_progress",
+        },
+    }
+
+
+def render_markdown(audit: dict) -> str:
+    summary = audit["summary"]
+    rows_by_year = {}
+    for item in audit["items"]:
+        rows_by_year.setdefault(item["year"], []).append(item)
+    lines = [
+        "# YRBS primary-outcome source audit",
+        "",
+        "Version: 1.0 | Status: provisional | Generated: 2026-09-20",
+        "",
+        "## Result",
+        "",
+        "All 17 national questionnaires and their annual data user guides were directly cross-checked for suicide ideation, plan, and attempt. The wording and answer options are stable across 1991-2023, but printed questionnaire numbers are not always the same as the variable numbers used in the released data.",
+        "",
+        f"The previous registry mapped {summary['previous_mapping_mismatch_items']} items in {len(summary['previous_mapping_mismatch_years'])} years to the wrong data variable: {', '.join(map(str, summary['previous_mapping_mismatch_years']))}. The correct columns are present in the annual 1991-2019 full Parquet files, and all observed codes stay within the official response domains. This is a registry/crosswalk defect, not loss of the underlying columns.",
+        "",
+        "## Annual crosswalk",
+        "",
+        "| Year | Data variables (ideation/plan/attempt) | Printed questionnaire numbers | Previous mapping | Data status |",
+        "|---:|---|---|---|---|",
+    ]
+    for year, items in sorted(rows_by_year.items()):
+        data_vars = "/".join(item["source_variable"] for item in items)
+        q_nums = "/".join(str(item["questionnaire_question_number"]) for item in items)
+        previous = "/".join(item["previous_registry_variable"] for item in items)
+        status = "verified" if all(item["mapping_status"] == "verified" for item in items) else "corrected"
+        lines.append(f"| {year} | `{data_vars}` | {q_nums} | {previous} ({status}) | {items[0]['data_status']} |")
+    lines += [
+        "",
+        "## Source interpretation",
+        "",
+        "- Data user guides/codebooks govern the released data-variable mapping; printed questionnaire numbers are retained as separate provenance fields.",
+        "- Ideation and plan use 1=Yes and 2=No. Attempt uses 1=0 times, 2=1 time, 3=2 or 3 times, 4=4 or 5 times, and 5=6 or more times.",
+        "- The 2023 printed questionnaire explicitly routes 0 attempts past the injury follow-up. That routing does not alter the primary attempt-frequency response itself.",
+        "- Annual guides report generic Missing counts but do not identify refusal, legitimate skip, data error, or other missing reasons for these primary items. Missing canonicalization therefore remains unresolved.",
+        "",
+        "## Gate 1 decision",
+        "",
+        "Gate 1 remains **in progress**. The 51 YRBS primary-outcome source records have a direct-source crosswalk, clean response options, and validated 1991-2023 full tables. Missing reasons still require the conservative rule, and two actual human reviewers have not yet signed the primary outcomes.",
+        "",
+        "## Reproduction",
+        "",
+        "Run `research/stage1/import_yrbs_2021_2023.py` first, then `research/stage1/audit_yrbs_primary_outcome_sources.py`. The scripts validate official layouts, verify source hashes, check all 1991-2023 annual Parquet schemas, and compare official versus previous mappings.",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def main() -> None:
+    audit = build_audit()
+    OUT_JSON.write_text(json.dumps(audit, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    OUT_MD.write_text(render_markdown(audit), encoding="utf-8")
+    print(json.dumps(audit["summary"], ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/build_human_review_packets.py

@@ -0,0 +1,55 @@
+"""Generate two independent, blank human-review packets and adjudication template."""
+
+from __future__ import annotations
+
+import csv
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE1 = ROOT / "research" / "stage1"
+QUEUE = STAGE1 / "primary_outcome_human_review_queue.csv"
+
+EVIDENCE = [
+    "item_version_id", "survey", "component_id", "construct", "question_text",
+    "response_dictionary_rows", "population", "language", "source_file", "source_url", "page_or_section",
+]
+REVIEW = [
+    "reviewer_name", "reviewer_affiliation", "review_date", "decision",
+    "wording_verified", "construct_verified", "population_verified", "response_codes_verified",
+    "skip_logic_verified", "missing_rules_verified", "language_evidence_status",
+    "corrected_question_text", "corrected_construct", "corrected_population", "corrected_language",
+    "corrected_response_or_missing_rule", "review_notes", "independence_attestation",
+]
+
+
+def write(path: Path, rows: list[dict[str, str]], fields: list[str]) -> None:
+    with path.open("w", encoding="utf-8-sig", newline="") as handle:
+        writer = csv.DictWriter(handle, fieldnames=fields)
+        writer.writeheader()
+        writer.writerows(rows)
+
+
+def main() -> None:
+    with QUEUE.open(encoding="utf-8-sig", newline="") as handle:
+        source = list(csv.DictReader(handle))
+    if len(source) != 84 or len({row["item_version_id"] for row in source}) != 84:
+        raise AssertionError("Expected 84 unique primary-outcome item instances")
+    blank = [{**{field: row[field] for field in EVIDENCE}, **{field: "" for field in REVIEW}} for row in source]
+    write(STAGE1 / "primary_outcome_review_reviewer_1.csv", blank, EVIDENCE + REVIEW)
+    write(STAGE1 / "primary_outcome_review_reviewer_2.csv", blank, EVIDENCE + REVIEW)
+    adjudication_fields = [
+        "item_version_id", "reviewer_1_decision", "reviewer_2_decision", "conflict_reason",
+        "adjudicator_name", "adjudication_date", "final_decision", "final_question_text",
+        "final_construct", "final_population", "final_language", "final_response_or_missing_rule",
+        "adjudication_notes", "adjudicator_attestation",
+    ]
+    write(STAGE1 / "primary_outcome_review_adjudication.csv", [
+        {field: (row["item_version_id"] if field == "item_version_id" else "") for field in adjudication_fields}
+        for row in source
+    ], adjudication_fields)
+    print({"reviewer_1_rows": len(blank), "reviewer_2_rows": len(blank), "adjudication_rows": len(blank)})
+
+
+if __name__ == "__main__":
+    main()

research/stage1/build_primary_outcome_package.py

@@ -0,0 +1,446 @@
+"""Build the provisional Gate-1 package for primary suicide outcomes.
+
+The outputs are deliberately conservative.  They preserve explicit uncertainty,
+refusal, skip, and unknown-missing states and never fill human reviewer fields.
+They are suitable for pipeline development only until the workflow's two-person
+review requirement and remaining data/design checks are complete.
+"""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from pathlib import Path
+from typing import Any, Iterable
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE1 = ROOT / "research" / "stage1"
+
+
+def load_json(name: str) -> dict[str, Any]:
+    with (STAGE1 / name).open(encoding="utf-8") as handle:
+        return json.load(handle)
+
+
+def write_csv(name: str, rows: list[dict[str, Any]], fields: Iterable[str]) -> None:
+    path = STAGE1 / name
+    with path.open("w", encoding="utf-8-sig", newline="") as handle:
+        writer = csv.DictWriter(handle, fieldnames=list(fields), extrasaction="raise")
+        writer.writeheader()
+        writer.writerows(rows)
+
+
+def stringify(value: Any) -> str:
+    if value is None:
+        return ""
+    if isinstance(value, bool):
+        return "true" if value else "false"
+    return str(value)
+
+
+def item_id(survey: str, component: str, variable: str) -> str:
+    return f"{survey}::{component}::{variable}"
+
+
+CONSTRUCT_META = {
+    "suicide_ideation": {
+        "label": "suicidal ideation",
+        "definition": "Serious consideration of attempting or trying to die by suicide during the stated time window.",
+    },
+    "suicide_plan": {
+        "label": "suicide plan",
+        "definition": "Making a plan about how to attempt or die by suicide during the stated time window.",
+    },
+    "suicide_attempt": {
+        "label": "suicide attempt",
+        "definition": "A self-reported attempt or try to die by suicide during the stated time window; frequency and binary forms remain distinct.",
+    },
+}
+
+
+def build() -> dict[str, int]:
+    registry = load_json("primary_outcome_registry.json")
+    gshs_audit = load_json("gshs_primary_outcome_component_audit.json")
+    yrbs_audit = load_json("yrbs_primary_outcome_source_audit.json")
+
+    registry_rows = registry["candidate_records"]
+    gshs_templates = {r["source_variable"]: r for r in registry_rows if r["survey"] == "GSHS"}
+    nsduh_rows = [r for r in registry_rows if r["survey"] == "NSDUH"]
+    observed_gshs = [c for c in gshs_audit["components"] if c["primary_outcomes_observed"]]
+    yrbs_rows = yrbs_audit["items"]
+
+    items: list[dict[str, Any]] = []
+    responses: list[dict[str, Any]] = []
+    designs: list[dict[str, Any]] = []
+    review_queue: list[dict[str, Any]] = []
+    conflicts: list[dict[str, Any]] = []
+
+    item_fields = [
+        "item_version_id", "item_family_id", "survey_id", "component_id", "survey", "country",
+        "year", "scope", "population", "source_variable", "question_text", "text_hash", "construct", "time_window",
+        "response_type", "language", "questionnaire_version", "data_availability", "analysis_eligibility",
+        "source_file", "source_url", "page_or_section", "reviewer_1", "reviewer_2", "review_status", "notes",
+    ]
+    response_fields = [
+        "item_version_id", "raw_code", "raw_label", "canonical_code", "missing_type", "is_observed_response",
+        "derivation_rule", "source_file", "source_url", "page_or_section", "review_status",
+    ]
+
+    def add_item(row: dict[str, Any], options: dict[str, str], missing_row: bool = False) -> None:
+        clean = {field: stringify(row.get(field)) for field in item_fields}
+        clean["text_hash"] = hashlib.sha256(clean["question_text"].encode("utf-8")).hexdigest()
+        items.append(clean)
+        for code, label in options.items():
+            canonical, missing_type, observed = canonicalize(clean["survey"], clean["construct"], str(code), label)
+            responses.append({
+                "item_version_id": clean["item_version_id"],
+                "raw_code": str(code),
+                "raw_label": label,
+                "canonical_code": canonical,
+                "missing_type": missing_type,
+                "is_observed_response": stringify(observed),
+                "derivation_rule": "direct recode; no imputation and no silent conversion of nonresponse to a negative response",
+                "source_file": clean["source_file"],
+                "source_url": clean["source_url"],
+                "page_or_section": clean["page_or_section"],
+                "review_status": "provisional",
+            })
+        if missing_row:
+            responses.append({
+                "item_version_id": clean["item_version_id"],
+                "raw_code": "<missing>",
+                "raw_label": "blank/null/sysmiss; source does not distinguish reason",
+                "canonical_code": "",
+                "missing_type": "unknown",
+                "is_observed_response": "false",
+                "derivation_rule": "retain as unknown missing; never recode as No/zero without an explicit official rule",
+                "source_file": clean["source_file"],
+                "source_url": clean["source_url"],
+                "page_or_section": clean["page_or_section"],
+                "review_status": "provisional",
+            })
+        review_queue.append({
+            "item_version_id": clean["item_version_id"],
+            "survey": clean["survey"],
+            "component_id": clean["component_id"],
+            "construct": clean["construct"],
+            "question_text": clean["question_text"],
+            "response_dictionary_rows": str(len(options) + int(missing_row)),
+            "population": clean["population"],
+            "language": clean["language"],
+            "source_file": clean["source_file"],
+            "source_url": clean["source_url"],
+            "page_or_section": clean["page_or_section"],
+            "reviewer_1": "",
+            "reviewer_1_decision": "",
+            "reviewer_1_date": "",
+            "reviewer_2": "",
+            "reviewer_2_decision": "",
+            "reviewer_2_date": "",
+            "adjudicator": "",
+            "adjudication": "",
+            "review_status": "provisional_pending_two_human_reviewers",
+            "review_instructions": "Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review.",
+        })
+
+    # GSHS: instantiate the three administered raw items for each observed component.
+    for component in observed_gshs:
+        package = component.get("source_package") or {}
+        documents = package.get("documents") or []
+        questionnaire = next((d for d in documents if "questionnaire" in d.get("role", "").lower()), None)
+        source_file = questionnaire.get("source_file", "") if questionnaire else ""
+        source_url = "" if source_file else component.get("catalog_url", "")
+        language = "; ".join(package.get("source_language_evidence") or []) or "source language not established"
+        questions = package.get("question_numbers") or {}
+        construct_to_q = {"suicide_ideation": questions.get("ideation"), "suicide_plan": questions.get("plan"), "suicide_attempt": questions.get("attempt")}
+        survey_id = f"GSHS::{component['reference_id']}"
+        for variable in ("raw_mh_considersui", "raw_mh_plansui", "raw_mh_attemptsui"):
+            template = gshs_templates[variable]
+            construct = template["construct"]
+            version = item_id("GSHS", component["component_id"], variable)
+            options = {str(k): str(v) for k, v in template["answer_options"].items()}
+            add_item({
+                "item_version_id": version,
+                "item_family_id": f"GSHS::{construct}::past_12_months",
+                "survey_id": survey_id,
+                "component_id": component["component_id"],
+                "survey": "GSHS",
+                "country": component.get("country"),
+                "year": str(component.get("collection_start", ""))[:4],
+                "scope": component.get("survey_scope"),
+                "population": component.get("population"),
+                "source_variable": variable,
+                "question_text": template["question_text"],
+                "construct": construct,
+                "time_window": template["time_window"],
+                "response_type": "ordinal_frequency" if construct == "suicide_attempt" else "binary",
+                "language": language + "; actual administered language not established",
+                "questionnaire_version": component["reference_id"],
+                "data_availability": "available_in_local_component",
+                "analysis_eligibility": "provisional_pipeline_development_only",
+                "source_file": source_file or template.get("source_file"),
+                "source_url": source_url or template.get("source_url"),
+                "page_or_section": construct_to_q[construct] or template.get("page_or_section"),
+                "reviewer_1": "", "reviewer_2": "", "review_status": "provisional",
+                "notes": "Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item.",
+            }, options, missing_row=True)
+        conflicts.append({
+            "conflict_id": f"GSHS_LANGUAGE::{component['component_id']}",
+            "survey": "GSHS", "year": str(component.get("collection_start", ""))[:4],
+            "component_id": component["component_id"], "source_variable": "all_primary_outcomes",
+            "conflict_type": "evidence_gap_administered_language",
+            "source_a": source_file or source_url, "source_b": "",
+            "description": "Available questionnaire language evidence does not establish the language administered to every respondent.",
+            "resolution": "unresolved; retain language as provisional and exclude language-DIF claims",
+            "analysis_consequence": "May be used for pipeline development, not confirmatory language comparison.",
+            "status": "open", "reviewer_1": "", "reviewer_2": "",
+        })
+        designs.append({
+            "survey_id": survey_id, "component_id": component["component_id"], "survey": "GSHS",
+            "country": component.get("country", ""), "year": str(component.get("collection_start", ""))[:4],
+            "population": component.get("population", ""), "weight_field": "sample_weight", "psu_field": "sampling_psu",
+            "stratum_field": "sampling_stratum", "variance_method": "complex-survey design using weight, stratum, and PSU; Taylor linearization planned",
+            "namespace_rule": "prefix PSU and stratum with component_id before pooling",
+            "design_source": f"{component.get('catalog_url', '')}; WHO GSHS methodology and data catalog", "design_status": "source_verified_fields",
+            "notes": "For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling.",
+            "review_status": "provisional",
+        })
+
+    # YRBS: source-audited annual items.
+    for source in yrbs_rows:
+        year = str(source["year"])
+        construct = source["construct"]
+        variable = source["source_variable"]
+        version = item_id("YRBS", year, variable)
+        add_item({
+            "item_version_id": version,
+            "item_family_id": f"YRBS::{construct}::past_12_months",
+            "survey_id": f"YRBS::{year}", "component_id": f"YRBS_NATIONAL::{year}", "survey": "YRBS",
+            "country": "United States", "year": year, "scope": "national",
+            "population": source["population"], "source_variable": variable,
+            "question_text": source["question_text"], "construct": construct, "time_window": source["time_window"],
+            "response_type": source["response_type"], "language": source["language"],
+            "questionnaire_version": f"YRBS national questionnaire {year}",
+            "data_availability": source["data_status"],
+            "analysis_eligibility": "provisional_pipeline_development_only",
+            "source_file": source["questionnaire_source_file"], "source_url": "",
+            "page_or_section": f"{source['questionnaire_page_or_section']}; data guide {source['data_guide_page_or_section']}",
+            "reviewer_1": "", "reviewer_2": "", "review_status": "provisional",
+            "notes": source["missing_rule_status"],
+        }, {str(k): str(v) for k, v in source["answer_options"].items()}, missing_row=True)
+        if source.get("previous_registry_variable") != variable:
+            conflicts.append({
+                "conflict_id": f"YRBS_MAPPING::{year}::{construct}", "survey": "YRBS", "year": year,
+                "component_id": f"YRBS_NATIONAL::{year}", "source_variable": variable,
+                "conflict_type": "registry_to_data_variable_mapping",
+                "source_a": source["questionnaire_source_file"], "source_b": source["data_guide_source_file"],
+                "description": f"Previous registry used {source['previous_registry_variable']}; direct annual data guide maps the printed question to {variable}.",
+                "resolution": f"Corrected registry mapping to {variable}; printed questionnaire number retained separately.",
+                "analysis_consequence": "Use corrected data variable; do not reuse the superseded mapping.",
+                "status": "resolved_by_direct_source_audit", "reviewer_1": "", "reviewer_2": "",
+            })
+
+    for year in sorted({str(r["year"]) for r in yrbs_rows}):
+        if year == "1997":
+            status = "source_verified_one_missing_record"
+        else:
+            status = "source_verified"
+        designs.append({
+            "survey_id": f"YRBS::{year}", "component_id": f"YRBS_NATIONAL::{year}", "survey": "YRBS",
+            "country": "United States", "year": year,
+            "population": "students in grades 9-12 attending public and private schools in the United States",
+            "weight_field": "weight", "psu_field": "psu", "stratum_field": "stratum",
+            "variance_method": "complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported",
+            "namespace_rule": "prefix PSU and stratum with survey year before pooling",
+            "design_source": next(r["data_guide_source_file"] for r in yrbs_rows if str(r["year"]) == year),
+            "design_status": status,
+            "notes": "Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling.",
+            "review_status": "provisional",
+        })
+
+    # NSDUH: four youth-module years. Attempt is documented but unavailable locally.
+    nsduh_options = {
+        "1": "Yes", "2": "No", "3": "I'm not sure", "4": "I don't want to answer",
+        "85": "BAD DATA Logically assigned", "94": "DON'T KNOW", "97": "REFUSED",
+        "98": "BLANK (NO ANSWER)", "99": "LEGITIMATE SKIP",
+    }
+    for source in nsduh_rows:
+        year = str(source["year"])
+        construct = source["construct"]
+        variable = source["source_variable"]
+        available = bool(source.get("present_in_full_table"))
+        version = item_id("NSDUH", year, variable)
+        add_item({
+            "item_version_id": version,
+            "item_family_id": f"NSDUH::{construct}::past_12_months",
+            "survey_id": f"NSDUH::{year}", "component_id": f"NSDUH_YOUTH::{year}", "survey": "NSDUH",
+            "country": "United States", "year": year, "scope": "national household survey youth module",
+            "population": "adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off",
+            "source_variable": variable, "question_text": source["question_text"], "construct": construct,
+            "time_window": source["time_window"], "response_type": "categorical_binary_with_explicit_uncertainty",
+            "language": "English source metadata; administered-language/accommodation coverage not established",
+            "questionnaire_version": f"NSDUH {year} youth module",
+            "data_availability": "available_in_local_public_use_table" if available else "administered_but_not_available_in_local_public_use_package",
+            "analysis_eligibility": "provisional_pipeline_development_only" if available else "not_analyzable_without_authorized_source",
+            "source_file": source.get("source_file") or "", "source_url": source.get("source_url") or "",
+            "page_or_section": source.get("page_or_section") or variable,
+            "reviewer_1": "", "reviewer_2": "", "review_status": "provisional",
+            "notes": source.get("notes", ""),
+        }, {str(k): str(v) for k, v in (source.get("answer_options") or nsduh_options).items()}, missing_row=False)
+        if not available:
+            conflicts.append({
+                "conflict_id": f"NSDUH_AVAILABILITY::{year}::{variable}", "survey": "NSDUH", "year": year,
+                "component_id": f"NSDUH_YOUTH::{year}", "source_variable": variable,
+                "conflict_type": "official_item_missing_from_local_public_use_microdata",
+                "source_a": source.get("source_url", ""), "source_b": "local full and selected schemas",
+                "description": "Official source documents the youth attempt item, but neither its raw nor recoded field is present in the local public-use files.",
+                "resolution": "unresolved access constraint; retain in item bank but do not generate responses",
+                "analysis_consequence": "NSDUH attempt cannot enter respondent-level analysis without authorized restricted-use data or a separately justified aggregate design.",
+                "status": "open_access_constraint", "reviewer_1": "", "reviewer_2": "",
+            })
+
+    for year in sorted({str(r["year"]) for r in nsduh_rows}):
+        designs.append({
+            "survey_id": f"NSDUH::{year}", "component_id": f"NSDUH_YOUTH::{year}", "survey": "NSDUH",
+            "country": "United States", "year": year, "population": "adolescents aged 12-17",
+            "weight_field": "ANALWT2_C1 (single-year); C2/C3/C4 are C1 divided by 2/3/4 for pooled annual averages", "psu_field": "VEREP",
+            "stratum_field": "VESTR_C", "variance_method": "Taylor series linearization; 50 df for 2014 onward national PUF estimates",
+            "namespace_rule": "retain full-sample design and specify CATAG2=1 as a survey domain; do not physically subset before variance estimation",
+            "design_source": "Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf sections 6, 8, 9, 10 and 12; official annual API metadata",
+            "design_status": "source_verified",
+            "notes": "Local C2=C1/2, C3=C1/3, and C4=C1/4 exactly for every row. Use C1 for a single year. VESTR_C and VEREP are complete; domain analysis must retain all PSUs.",
+            "review_status": "provisional",
+        })
+
+    links = []
+    for construct in CONSTRUCT_META:
+        for left, right in (("GSHS", "YRBS"), ("GSHS", "NSDUH"), ("YRBS", "NSDUH")):
+            links.append({
+                "item_pair": f"{left}::{construct} <-> {right}::{construct}",
+                "left_item_family_id": f"{left}::{construct}::past_12_months",
+                "right_item_family_id": f"{right}::{construct}::past_12_months",
+                "relation_type": "conceptual_candidate_only",
+                "semantic_evidence": "same provisional construct and 12-month window; wording, response form, population, and mode differ",
+                "population_overlap": "adolescent age overlap exists but sampling frames differ",
+                "anchor_status": "not_approved",
+                "exclusion_reason": "No empirical invariance, coadministration, or human double-review evidence yet.",
+                "review_status": "provisional",
+            })
+
+    item_ids = [row["item_version_id"] for row in items]
+    response_item_ids = {row["item_version_id"] for row in responses}
+    assert len(items) == 84, f"Expected 84 item instances, found {len(items)}"
+    assert len(set(item_ids)) == len(item_ids), "item_version_id must be unique"
+    assert response_item_ids == set(item_ids), "Every item must have response-dictionary coverage"
+    assert len(review_queue) == len(items), "Every item must have one human-review queue row"
+    assert all(not row["reviewer_1"] and not row["reviewer_2"] for row in items), "Generated data cannot claim human review"
+    assert all(row["anchor_status"] == "not_approved" for row in links), "No anchor may be approved during package generation"
+    assert all(row["source_file"] or row["source_url"] for row in items), "Every item must have a source pointer"
+    assert all(row["population"] for row in items), "Every item must state its provisional population"
+
+    write_csv("item_bank.csv", items, item_fields)
+    write_csv("response_dictionary.csv", responses, response_fields)
+    write_csv("survey_design.csv", designs, [
+        "survey_id", "component_id", "survey", "country", "year", "population", "weight_field", "psu_field",
+        "stratum_field", "variance_method", "namespace_rule", "design_source", "design_status", "review_status", "notes",
+    ])
+    write_csv("item_links.csv", links, [
+        "item_pair", "left_item_family_id", "right_item_family_id", "relation_type", "semantic_evidence",
+        "population_overlap", "anchor_status", "exclusion_reason", "review_status",
+    ])
+    write_csv("source_conflicts.csv", conflicts, [
+        "conflict_id", "survey", "year", "component_id", "source_variable", "conflict_type", "source_a", "source_b",
+        "description", "resolution", "analysis_consequence", "status", "reviewer_1", "reviewer_2",
+    ])
+    write_csv("primary_outcome_human_review_queue.csv", review_queue, [
+        "item_version_id", "survey", "component_id", "construct", "question_text", "response_dictionary_rows",
+        "population", "language", "source_file", "source_url", "page_or_section", "reviewer_1",
+        "reviewer_1_decision", "reviewer_1_date", "reviewer_2", "reviewer_2_decision", "reviewer_2_date",
+        "adjudicator", "adjudication", "review_status", "review_instructions",
+    ])
+    write_ontology()
+    write_readme(len(items), len(responses), len(designs), len(conflicts))
+
+    return {
+        "items": len(items), "response_codes": len(responses), "design_rows": len(designs),
+        "candidate_links": len(links), "source_conflicts": len(conflicts), "review_queue": len(review_queue),
+    }
+
+
+def canonicalize(survey: str, construct: str, code: str, label: str) -> tuple[str, str, bool]:
+    if survey in {"GSHS", "YRBS"}:
+        if code == "1":
+            return ("zero" if construct == "suicide_attempt" else "yes", "", True)
+        if code == "2":
+            return ("one" if construct == "suicide_attempt" else "no", "", True)
+        if construct == "suicide_attempt":
+            return {"3": ("two_or_three", "", True), "4": ("four_or_five", "", True), "5": ("six_or_more", "", True)}[code]
+    if survey == "NSDUH":
+        mapping = {
+            "1": ("yes", "", True), "2": ("no", "", True),
+            "3": ("uncertain", "", True), "4": ("", "refused", False),
+            "85": ("", "data_error", False), "94": ("", "dont_know", False),
+            "97": ("", "refused", False), "98": ("", "ordinary_missing", False),
+            "99": ("", "legitimate_skip", False),
+        }
+        return mapping[code]
+    raise ValueError(f"Unsupported response code: {survey=} {construct=} {code=} {label=}")
+
+
+def write_ontology() -> None:
+    lines = [
+        "schema_version: '1.0'",
+        "status: provisional",
+        "human_double_review_complete: false",
+        "confirmatory_analysis_allowed: false",
+        "constructs:",
+    ]
+    for key, meta in CONSTRUCT_META.items():
+        lines.extend([
+            f"  {key}:",
+            f"    label: {meta['label']}",
+            f"    definition: {meta['definition']}",
+            "    primary_outcome: true",
+            "    default_time_window: past 12 months",
+            "    review_status: provisional",
+        ])
+    lines.extend([
+        "explicit_exclusions:",
+        "  - self-harm without stated suicidal intent is a separate construct",
+        "  - sadness or hopelessness is not a suicide-outcome substitute",
+        "  - attempt-related injury and medical-treatment follow-ups are not substitutes for attempt occurrence",
+        "  - derived binary fields are not independent administered items",
+        "linking_rules:",
+        "  - semantic similarity creates a candidate link only",
+        "  - cross-survey equivalence requires population, wording, coding, and empirical invariance review",
+        "  - no item family is an approved anchor at this stage",
+        "missingness_rules:",
+        "  - never recode unknown missing, refusal, don't know, or legitimate skip as a negative response without an explicit official rule",
+        "  - retain explicit uncertainty as an observed category until the analysis protocol states otherwise",
+        "  - keep raw response and any later binary derivation as separate fields with an auditable rule",
+    ])
+    (STAGE1 / "construct_ontology.yaml").write_text("\n".join(lines) + "\n", encoding="utf-8")
+
+
+def write_readme(items: int, responses: int, designs: int, conflicts: int) -> None:
+    text = f"""# Gate 1 primary-outcome package
+
+Status: **provisional; pipeline development only**.
+
+Generated from the direct-source registry and audits by `build_primary_outcome_package.py`.
+
+- item instances: {items}
+- response-dictionary rows: {responses}
+- survey/component design rows: {designs}
+- source conflicts or evidence gaps: {conflicts}
+- human reviewers recorded: 0
+
+The package does not satisfy Gate 1 by itself. `responses_long.parquet` has passed structural validation, but two actual human reviewers must independently sign every primary-outcome item; NSDUH youth attempt is absent from local public-use microdata; and several design and administered-language fields remain provisional.
+"""
+    (STAGE1 / "primary_outcome_package.md").write_text(text, encoding="utf-8")
+
+
+if __name__ == "__main__":
+    print(json.dumps(build(), indent=2, ensure_ascii=False))

research/stage1/build_primary_outcome_registry.py

@@ -19,6 +19,7 @@ ROOT = Path(__file__).resolve().parents[2]
 STAGE_DIR = ROOT / "research" / "stage1"
 GSHS_BOOK = ROOT / "Dataset" / "GSHS-全球学生健康调查数据" / "GSHS" / "02_documentation" / "GSHS_数据字典.xlsx"
 YRBS_DIR = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "YRBS"
+YRBS_AUDIT = STAGE_DIR / "yrbs_primary_outcome_source_audit.json"
 NSDUH_DIR = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "NSDUH"
 OUT_JSON = STAGE_DIR / "primary_outcome_registry.json"
 OUT_MD = STAGE_DIR / "primary_outcome_registry.md"
@@ -26,14 +27,31 @@ OUT_MD = STAGE_DIR / "primary_outcome_registry.md"
 PRIMARY_CONSTRUCTS = {"suicide_ideation", "suicide_plan", "suicide_attempt"}
 GSHS_CONSTRUCT = {
     "raw_mh_considersui": "suicide_ideation",
-    "raw_mh_b_considersui": "suicide_ideation",
     "raw_mh_plansui": "suicide_plan",
-    "raw_mh_b_plansui": "suicide_plan",
     "raw_mh_attemptsui": "suicide_attempt",
-    "raw_mh_b_attemptsui": "suicide_attempt",
+}
+GSHS_DERIVED = {
+    "raw_mh_b_considersui": ("suicide_ideation", "raw_mh_considersui", "identity binary representation"),
+    "raw_mh_b_plansui": ("suicide_plan", "raw_mh_plansui", "identity binary representation"),
+    "raw_mh_b_attemptsui": (
+        "suicide_attempt",
+        "raw_mh_attemptsui",
+        "1=Yes when attempt frequency is one or more; 2=No when frequency is zero",
+    ),
+}
+GSHS_QUESTION = {
+    "raw_mh_considersui": "During the past 12 months, did you seriously consider attempting suicide?",
+    "raw_mh_plansui": "During the past 12 months, did you make a plan about how you would attempt suicide?",
+    "raw_mh_attemptsui": "During the past 12 months, how many times did you attempt suicide?",
 }
 NSDUH_YOUTH_RAW = {"YUSUITHK": "suicide_ideation", "YUSUIPLN": "suicide_plan"}
 NSDUH_YOUTH_DERIVED = {"YUSUITHKYR": "suicide_ideation", "YUSUIPLNYR": "suicide_plan"}
+NSDUH_ATTEMPT_SOURCES = {
+    2021: "https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf",
+    2022: "https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf",
+    2023: "https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf",
+    2024: "https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf",
+}
 
 
 def clean_text(value: object) -> str:
@@ -54,67 +72,90 @@ def parquet_columns(path: Path) -> set[str]:
     return set(pq.ParquetFile(path).schema_arrow.names)
 
 
-def build_gshs() -> list[dict]:
+def build_gshs() -> tuple[list[dict], list[dict]]:
     frame = pd.read_excel(GSHS_BOOK, sheet_name="Master_Columns", dtype=str, keep_default_na=False)
-    frame = frame[frame["column_name"].isin(GSHS_CONSTRUCT)].copy()
+    frame = frame[frame["column_name"].isin(set(GSHS_CONSTRUCT) | set(GSHS_DERIVED))].copy()
-    records = []
+    records: list[dict] = []
+    derived_records: list[dict] = []
     for row in frame.sort_values("ordinal").to_dict("records"):
-        records.append(
+        variable = row["column_name"]
-            {
+        common = {
             "survey": "GSHS",
             "year": None,
-                "source_variable": row["column_name"],
+            "source_variable": variable,
-                "construct": GSHS_CONSTRUCT[row["column_name"]],
+            "population": "school-attending students; exact component ages/grades pending source review",
-                "record_type": "raw_candidate",
+            "time_window": "past 12 months",
-                "population": "school-attending students; exact component ages pending source review",
-                "time_window": "past 12 months (from source label; questionnaire verification pending)",
-                "question_text": None,
             "source_label": clean_text(row["label_variants"]),
             "answer_options": parse_json_object(row["value_labels_example"]),
             "source_file": str(GSHS_BOOK.relative_to(ROOT)).replace("\\", "/"),
+            "component_audit_file": "research/stage1/gshs_primary_outcome_component_audit.json",
             "source_url": None,
-                "page_or_section": "Master_Columns",
+            "page_or_section": "Master_Columns plus component-specific questionnaire/codebook references in component audit",
             "present_in_local_data": True,
-                "source_verification_status": "pending_questionnaire_review",
+            "source_verification_status": "direct_sources_verified_for_all_seven_observed_components_six_local_packages_one_official_catalog",
             "review_status": "provisional",
             "reviewer_1": None,
             "reviewer_2": None,
             "link_status": "not_evaluated",
-                "notes": "The `_b_` and unprefixed forms remain separate item versions; labels alone do not prove equivalence.",
+        }
+        if variable in GSHS_CONSTRUCT:
+            common.update(
+                {
+                    "construct": GSHS_CONSTRUCT[variable],
+                    "record_type": "administered_raw_candidate",
+                    "question_text": GSHS_QUESTION[variable],
+                    "notes": "Country questionnaires/ordinary codebooks cover six components; official WHO catalog item metadata covers Solomon Islands 2023. Administration language and missing rules are not approved.",
                 }
             )
-    return records
+            records.append(common)
+        else:
+            construct, source_variable, derivation_rule = GSHS_DERIVED[variable]
+            common.update(
+                {
+                    "construct": construct,
+                    "record_type": "derived_or_duplicate_binary_indicator",
+                    "question_text": None,
+                    "derived_from": source_variable,
+                    "derivation_rule": derivation_rule,
+                    "notes": "Binary Codebooks and exact row-level mapping show this is not an independent administered item.",
+                }
+            )
+            derived_records.append(common)
+    return records, derived_records
 
 
 def build_yrbs() -> list[dict]:
-    source = YRBS_DIR / "yrbs_selected_variable_dictionary.csv"
+    audit = json.loads(YRBS_AUDIT.read_text(encoding="utf-8"))
-    frame = pd.read_csv(source, dtype=str, keep_default_na=False)
-    frame = frame[frame["construct"].isin(PRIMARY_CONSTRUCTS)].copy()
     records = []
-    for row in frame.sort_values(["year", "variable"]).to_dict("records"):
+    for row in sorted(audit["items"], key=lambda item: (item["year"], item["construct"])):
-        year = int(row["year"])
+        year = row["year"]
         records.append(
             {
                 "survey": "YRBS",
                 "year": year,
-                "source_variable": row["variable"],
+                "source_variable": row["source_variable"],
                 "construct": row["construct"],
                 "record_type": "raw_candidate",
-                "population": "national high-school students; exact eligibility pending annual source review",
+                "population": row["population"],
-                "time_window": clean_text(row["time_window"]),
+                "time_window": row["time_window"],
-                "question_text": clean_text(row["original_question"]),
+                "question_text": row["question_text"],
-                "answer_options": parse_json_object(row["answer_options_json"]),
+                "answer_options": row["answer_options"],
-                "source_file": str(source.relative_to(ROOT)).replace("\\", "/"),
+                "source_file": row["questionnaire_source_file"],
-                "source_url": clean_text(row["official_url"]),
+                "data_guide_source_file": row["data_guide_source_file"],
-                "page_or_section": row["questionnaire_version"],
+                "source_url": "https://www.cdc.gov/yrbs/questionnaires/index.html",
+                "page_or_section": f"questionnaire {row['questionnaire_page_or_section']}; data guide {row['data_guide_page_or_section']}",
+                "questionnaire_question_number": row["questionnaire_question_number"],
+                "data_user_guide_variable_number": row["data_user_guide_variable_number"],
+                "previous_registry_variable": row["previous_registry_variable"],
+                "mapping_status": row["mapping_status"],
                 "present_in_local_data": year <= 2019,
-                "data_status": "available_selected_table" if year <= 2019 else "quarantined_pending_import_validation",
+                "data_status": row["data_status"],
-                "source_verification_status": "pending_direct_pdf_review",
+                "source_verification_status": "direct_questionnaire_and_data_user_guide_reviewed",
                 "review_status": "provisional",
                 "reviewer_1": None,
                 "reviewer_2": None,
                 "link_status": "not_evaluated",
-                "notes": "Repository dictionary candidate only. Stale source-machine absolute paths are intentionally not copied.",
+                "notes": "Direct-source crosswalk supersedes the previous automatic mapping. Printed questionnaire number and released data variable are retained separately; missing reasons and human review remain unresolved.",
             }
         )
     return records
@@ -158,6 +199,44 @@ def build_nsduh() -> tuple[list[dict], list[dict], list[dict]]:
         item["notes"] = "Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified."
         raw_records.append(item)
 
+    for year, source_url in NSDUH_ATTEMPT_SOURCES.items():
+        raw_records.append(
+            {
+                "survey": "NSDUH",
+                "year": year,
+                "source_variable": "YUSUICTRY",
+                "construct": "suicide_attempt",
+                "record_type": "administered_raw_candidate_not_in_local_public_use_file",
+                "population": "adolescents aged 12–17",
+                "time_window": "past 12 months",
+                "question_text": "During the past 12 months, did you try to kill yourself?",
+                "source_label": "YOUTH TRY TO KILL YOURSELF PAST 12 MONTHS",
+                "answer_options": {
+                    "1": "Yes",
+                    "2": "No",
+                    "3": "I'm not sure",
+                    "4": "I don't want to answer",
+                    "85": "BAD DATA Logically assigned",
+                    "94": "DON'T KNOW",
+                    "97": "REFUSED",
+                    "98": "BLANK (NO ANSWER)",
+                    "99": "LEGITIMATE SKIP",
+                },
+                "source_file": None,
+                "source_url": source_url,
+                "page_or_section": "YSUI03",
+                "present_in_full_table": "YUSUICTRY" in full_cols,
+                "present_in_selected_table": "YUSUICTRY" in selected_cols,
+                "data_access_status": "administered_but_not_available_in_local_public_use_package",
+                "source_verification_status": "official_indexed_text_verified_pdf_render_pending",
+                "review_status": "provisional",
+                "reviewer_1": None,
+                "reviewer_2": None,
+                "link_status": "not_evaluated",
+                "notes": "Asked of all adolescents aged 12–17, regardless of ideation response. Current local public-use schema omits the raw and recoded attempt variables; this row is not analyzable without an authorized source.",
+            }
+        )
+
     for row in frame[frame["variable"].isin(NSDUH_YOUTH_DERIVED)].to_dict("records"):
         item = common(row, NSDUH_YOUTH_DERIVED[row["variable"]], "derived_youth_indicator")
         item["question_text"] = None
@@ -191,7 +270,7 @@ def render_markdown(registry: dict) -> str:
     lines = [
         "# Primary outcome source registry",
         "",
-        "Version: 1.0 | Status: provisional | Generated: 2026-09-20",
+        "Version: 1.4 | Status: provisional | Generated: 2026-09-20",
         "",
         "## Scope and decision boundary",
         "",
@@ -204,9 +283,9 @@ def render_markdown(registry: dict) -> str:
     ]
     for survey in ["GSHS", "YRBS", "NSDUH"]:
         boundary = {
-            "GSHS": "Workbook labels/options only; component questionnaires still require direct review.",
+            "GSHS": "Three administered items occur in 7/191 components; six local source packages plus WHO catalog metadata cover all seven.",
-            "YRBS": "51 annual candidates; 2021/2023 data remain quarantined; annual PDFs require direct review.",
+            "YRBS": "51 annual candidates directly cross-checked; 21 prior mappings corrected; 2021/2023 data remain quarantined.",
-            "NSDUH": "Official API metadata supports youth ideation/plan only; no youth attempt field appears in the local full dictionary.",
+            "NSDUH": "Attempt is administered as YSUI03/YUSUICTRY, but the raw and recoded attempt fields are absent from the local public-use package.",
         }[survey]
         lines.append(
             f"| {survey} | {counts[(survey, 'suicide_ideation')]} | {counts[(survey, 'suicide_plan')]} | {counts[(survey, 'suicide_attempt')]} | {boundary} |"
@@ -217,16 +296,17 @@ def render_markdown(registry: dict) -> str:
         "",
         "## Material conflicts and exclusions",
         "",
-        "- GSHS exposes both `_b_` and unprefixed variants. They differ in naming and, for attempt, response form (binary versus frequency). They remain separate until questionnaire/component provenance is verified.",
+        "- GSHS ordinary codebooks identify the three unprefixed variables as administered items. Binary Codebooks plus exact row-level relations identify the three `_b_` columns as derived or duplicate representations, not independent items.",
         "- GSHS self-harm variables are not included as suicide-attempt items.",
-        "- YRBS metadata contains stale absolute paths from another machine and some automatically extracted neighboring-text contamination. Only exact primary-construct rows were retained, and their direct PDF review is still pending.",
+        "- Direct annual questionnaire/user-guide review found 21 wrong data-column mappings in 1995, 2001, 2003, 2005, 2007, 2009, and 2011. This registry now uses the corrected user-guide variables and retains printed questionnaire numbers separately.",
         "- YRBS 2021 and 2023 item metadata are retained for future migration checks, but their respondent data are quarantined pending layout/import validation.",
         "- NSDUH adult, COVID-conditioned, imputed, recoded, and composite variables are not treated as primary raw youth items.",
-        "- NSDUH youth attempt questions `YSUI03`–`YSUI05` are mentioned in notes, but no corresponding youth attempt variable appears in the local complete dictionary. Attempt coverage is therefore recorded as a source gap, not inferred from ideation wording.",
+        "- Official restricted-use codebooks and the 2024 questionnaire verify `YSUI03`/`YUSUICTRY` as the youth attempt item. It is administered independently of the ideation response, but is absent from the local public-use data and cannot be analyzed from the current package.",
+        "- `YSUI04`/`YUSUICMED` and `YSUI05`/`YUSUIHOSP` are conditional severity/follow-up items, not substitutes for the primary attempt item.",
         "",
         "## Gate 1 status",
         "",
-        "Gate 1 remains **in progress**. Before any candidate can enter confirmatory analysis, the project still needs direct official questionnaire/codebook review, exact population and skip-logic verification, canonical response/missing rules, component-specific GSHS provenance, and two actual human reviewers for primary outcomes.",
+        "Gate 1 remains **in progress**. Before any candidate can enter confirmatory analysis, the project still needs exact remaining population/language and skip-logic verification, canonical response/missing rules, validated YRBS 2021/2023 imports, and two actual human reviewers for primary outcomes.",
         "",
         "## Reproduction",
         "",
@@ -237,25 +317,25 @@ def render_markdown(registry: dict) -> str:
 
 
 def main() -> None:
-    gshs = build_gshs()
+    gshs, gshs_derived = build_gshs()
     yrbs = build_yrbs()
     nsduh_raw, nsduh_derived, nsduh_excluded = build_nsduh()
     registry = {
-        "schema_version": "1.0",
+        "schema_version": "1.4",
         "generated_on": "2026-09-20",
         "status": "provisional",
         "allowed_uses": ["pipeline_development", "source_review_queue"],
         "prohibited_uses": ["confirmatory_analysis", "approved_anchor_links", "claim_of_human_double_review"],
         "candidate_records": gshs + yrbs + nsduh_raw,
-        "derived_records_not_independent_items": nsduh_derived,
+        "derived_records_not_independent_items": gshs_derived + nsduh_derived,
         "excluded_nsduh_records": nsduh_excluded,
-        "source_gaps": [
+        "availability_constraints": [
             {
                 "survey": "NSDUH",
                 "construct": "suicide_attempt",
-                "status": "not_found_in_local_complete_dictionary",
+                "status": "administered_but_unavailable_in_local_public_use_package",
-                "evidence": "YSUI03–YSUI05 are named in 2022–2024 module-move notes, but no youth attempt variable is exposed in the local 2021–2024 dictionary.",
+                "evidence": "Official restricted-use codebooks map YSUI03 to YUSUICTRY; the 2024 public-use guide states that the recoded youth attempt variable is excluded due to disclosure risk; neither raw nor recoded attempt fields occur in the local full/selected schemas.",
-                "next_check": "Review annual youth questionnaires/codebooks and public-use suppression/derivation notes.",
+                "analysis_consequence": "NSDUH can externally validate youth ideation and plan with current local microdata, but not youth attempt. Attempt analysis requires authorized restricted-use access or a separately justified aggregate-data design.",
             }
         ],
         "review_policy": {
@@ -269,7 +349,7 @@ def main() -> None:
     OUT_MD.write_text(render_markdown(registry), encoding="utf-8")
     print(json.dumps({
         "candidate_records": len(registry["candidate_records"]),
-        "derived_records": len(nsduh_derived),
+        "derived_records": len(registry["derived_records_not_independent_items"]),
         "excluded_nsduh_records": len(nsduh_excluded),
         "json": str(OUT_JSON.relative_to(ROOT)),
         "report": str(OUT_MD.relative_to(ROOT)),

research/stage1/build_responses_long.py

@@ -0,0 +1,241 @@
+"""Build the Gate-1 long response table from source-verified primary outcomes."""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from collections import Counter
+from pathlib import Path
+from typing import Any
+
+import duckdb
+import pyarrow as pa
+import pyarrow.parquet as pq
+
+
+ROOT = Path(__file__).resolve().parents[2]
+STAGE1 = ROOT / "research" / "stage1"
+GSHS = ROOT / "Dataset" / "GSHS-全球学生健康调查数据" / "GSHS" / "01_data" / "GSHS.csv"
+YRBS_DIR = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "YRBS" / "full_by_year"
+NSDUH = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "NSDUH" / "nsduh_2021_2024_full.parquet"
+OUTPUT = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "harmonization" / "responses_long.parquet"
+MANIFEST = STAGE1 / "responses_long_manifest.json"
+REPORT = STAGE1 / "responses_long_audit.md"
+
+SCHEMA = pa.schema([
+    ("respondent_id", pa.string()),
+    ("survey_id", pa.string()),
+    ("component_id", pa.string()),
+    ("survey_year", pa.int16()),
+    ("item_version_id", pa.string()),
+    ("raw_response", pa.string()),
+    ("canonical_response", pa.string()),
+    ("eligibility", pa.string()),
+    ("observed_status", pa.string()),
+    ("missing_type", pa.string()),
+    ("source_row", pa.int64()),
+])
+
+
+def load_csv(path: Path) -> list[dict[str, str]]:
+    with path.open(encoding="utf-8-sig", newline="") as handle:
+        return list(csv.DictReader(handle))
+
+
+def normalized_code(value: Any) -> str:
+    if value is None:
+        return "<missing>"
+    if isinstance(value, float) and value.is_integer():
+        return str(int(value))
+    text = str(value).strip()
+    if not text:
+        return "<missing>"
+    if text.endswith(".0"):
+        try:
+            return str(int(float(text)))
+        except ValueError:
+            pass
+    return text
+
+
+def sha256(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for block in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(block)
+    return digest.hexdigest()
+
+
+class LongWriter:
+    def __init__(self, path: Path, response_map: dict[tuple[str, str], dict[str, str]]) -> None:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        self.writer = pq.ParquetWriter(path, SCHEMA, compression="zstd")
+        self.response_map = response_map
+        self.buffer: list[dict[str, Any]] = []
+        self.rows_by_survey: Counter[str] = Counter()
+        self.rows_by_item: Counter[str] = Counter()
+        self.observed_status: Counter[str] = Counter()
+        self.missing_types: Counter[str] = Counter()
+
+    def add(self, *, respondent_id: str, survey_id: str, component_id: str, year: int,
+            item_version_id: str, raw_value: Any, eligibility: str, source_row: int) -> None:
+        raw_code = normalized_code(raw_value)
+        key = (item_version_id, raw_code)
+        if key not in self.response_map:
+            raise ValueError(f"No response dictionary entry for {key}")
+        mapping = self.response_map[key]
+        observed = mapping["is_observed_response"] == "true"
+        missing_type = mapping["missing_type"]
+        status = "observed" if observed else (missing_type or "missing")
+        survey = item_version_id.split("::", 1)[0]
+        self.buffer.append({
+            "respondent_id": respondent_id,
+            "survey_id": survey_id,
+            "component_id": component_id,
+            "survey_year": year,
+            "item_version_id": item_version_id,
+            "raw_response": None if raw_code == "<missing>" else raw_code,
+            "canonical_response": mapping["canonical_code"] or None,
+            "eligibility": eligibility,
+            "observed_status": status,
+            "missing_type": missing_type or None,
+            "source_row": source_row,
+        })
+        self.rows_by_survey[survey] += 1
+        self.rows_by_item[item_version_id] += 1
+        self.observed_status[status] += 1
+        if missing_type:
+            self.missing_types[missing_type] += 1
+        if len(self.buffer) >= 50_000:
+            self.flush()
+
+    def flush(self) -> None:
+        if self.buffer:
+            self.writer.write_table(pa.Table.from_pylist(self.buffer, schema=SCHEMA))
+            self.buffer.clear()
+
+    def close(self) -> None:
+        self.flush()
+        self.writer.close()
+
+
+def main() -> None:
+    item_rows = load_csv(STAGE1 / "item_bank.csv")
+    dictionary_rows = load_csv(STAGE1 / "response_dictionary.csv")
+    item_index = {(r["survey"], r["component_id"], r["source_variable"].lower()): r for r in item_rows}
+    response_map = {(r["item_version_id"], r["raw_code"]): r for r in dictionary_rows}
+    writer = LongWriter(OUTPUT, response_map)
+    expected_rows: dict[str, int] = {}
+
+    # GSHS: stream the large CSV, retaining only the seven source-verified components.
+    gshs_components = {r["component_id"] for r in item_rows if r["survey"] == "GSHS"}
+    gshs_vars = ["raw_mh_considersui", "raw_mh_plansui", "raw_mh_attemptsui"]
+    with GSHS.open(encoding="utf-8-sig", newline="") as handle:
+        reader = csv.DictReader(handle)
+        for source_row, row in enumerate(reader, start=1):
+            component = row["dataset_id"]
+            if component not in gshs_components:
+                continue
+            year = int(str(row["survey_year"])[:4])
+            survey_id = next(r["survey_id"] for r in item_rows if r["survey"] == "GSHS" and r["component_id"] == component)
+            respondent = f"{component}::{row['id']}"
+            for variable in gshs_vars:
+                item = item_index[("GSHS", component, variable)]
+                writer.add(respondent_id=respondent, survey_id=survey_id, component_id=component,
+                           year=year, item_version_id=item["item_version_id"], raw_value=row[variable],
+                           eligibility="eligible_administered_component", source_row=source_row)
+    gshs_audit = json.loads((STAGE1 / "gshs_primary_outcome_component_audit.json").read_text(encoding="utf-8"))
+    expected_rows["GSHS"] = sum(c["observed_rows"] for c in gshs_audit["components"] if c["primary_outcomes_observed"]) * 3
+
+    # YRBS: all 17 annual full tables have passed source/layout and value-domain checks.
+    yrbs_items = [r for r in item_rows if r["survey"] == "YRBS"]
+    yrbs_respondents = 0
+    for year in sorted({int(r["year"]) for r in yrbs_items}):
+        annual_items = [r for r in yrbs_items if int(r["year"]) == year]
+        columns = ["source_row", *[r["source_variable"].lower() for r in annual_items]]
+        table = pq.read_table(YRBS_DIR / f"yrbs_{year}_full.parquet", columns=columns).to_pydict()
+        yrbs_respondents += len(table["source_row"])
+        for offset, source_row in enumerate(table["source_row"]):
+            respondent = f"YRBS::{year}::{source_row}"
+            for item in annual_items:
+                variable = item["source_variable"].lower()
+                writer.add(respondent_id=respondent, survey_id=item["survey_id"], component_id=item["component_id"],
+                           year=year, item_version_id=item["item_version_id"], raw_value=table[variable][offset],
+                           eligibility="eligible_sampled_student", source_row=int(source_row))
+    expected_rows["YRBS"] = yrbs_respondents * 3
+
+    # NSDUH: restrict to CATAG2=1 (12-17); attempt is documented but absent from public-use data.
+    nsduh_items = [r for r in item_rows if r["survey"] == "NSDUH" and r["source_variable"] in {"YUSUITHK", "YUSUIPLN"}]
+    nsduh_table = pq.read_table(NSDUH, columns=["YEAR", "QUESTID2", "CATAG2", "YUSUITHK", "YUSUIPLN"]).to_pydict()
+    nsduh_youth = 0
+    for offset, age_group in enumerate(nsduh_table["CATAG2"]):
+        if normalized_code(age_group) != "1":
+            continue
+        nsduh_youth += 1
+        year = int(nsduh_table["YEAR"][offset])
+        annual_items = [r for r in nsduh_items if int(r["year"]) == year]
+        respondent = f"NSDUH::{year}::{nsduh_table['QUESTID2'][offset]}"
+        for item in annual_items:
+            variable = item["source_variable"]
+            writer.add(respondent_id=respondent, survey_id=item["survey_id"], component_id=item["component_id"],
+                       year=year, item_version_id=item["item_version_id"], raw_value=nsduh_table[variable][offset],
+                       eligibility="eligible_age_12_17", source_row=offset + 1)
+    expected_rows["NSDUH"] = nsduh_youth * 2
+    writer.close()
+
+    con = duckdb.connect()
+    path_sql = str(OUTPUT).replace("'", "''")
+    totals = con.execute(f"SELECT count(*), count(DISTINCT respondent_id || '|' || item_version_id), count(DISTINCT item_version_id) FROM read_parquet('{path_sql}')").fetchone()
+    null_checks = con.execute(f"SELECT count(*) FILTER (WHERE respondent_id IS NULL OR item_version_id IS NULL OR eligibility IS NULL OR observed_status IS NULL), count(*) FILTER (WHERE observed_status='observed' AND canonical_response IS NULL) FROM read_parquet('{path_sql}')").fetchone()
+    bad_codes = con.execute(f"SELECT count(*) FROM read_parquet('{path_sql}') WHERE observed_status='observed' AND raw_response IS NULL").fetchone()[0]
+    con.close()
+    if totals[0] != totals[1]:
+        raise AssertionError("respondent_id × item_version_id keys are not unique")
+    if null_checks != (0, 0) or bad_codes:
+        raise AssertionError(f"Long-table required-field/canonical checks failed: {null_checks=} {bad_codes=}")
+    if totals[2] != 80:
+        raise AssertionError(f"Expected responses for 80 locally analyzable items, found {totals[2]}")
+    if dict(writer.rows_by_survey) != expected_rows:
+        raise AssertionError(f"Source-derived row totals do not match output: {expected_rows=} actual={dict(writer.rows_by_survey)}")
+
+    manifest = {
+        "schema_version": "1.0", "generated_on": "2026-09-20", "status": "provisional",
+        "output_file": str(OUTPUT.relative_to(ROOT)).replace("\\", "/"),
+        "sha256": sha256(OUTPUT), "bytes": OUTPUT.stat().st_size,
+        "rows": totals[0], "unique_response_keys": totals[1], "item_instances_with_rows": totals[2],
+        "rows_by_survey": dict(sorted(writer.rows_by_survey.items())),
+        "source_derived_expected_rows": dict(sorted(expected_rows.items())),
+        "rows_by_item": dict(sorted(writer.rows_by_item.items())),
+        "observed_status_counts": dict(sorted(writer.observed_status.items())),
+        "missing_type_counts": dict(sorted(writer.missing_types.items())),
+        "required_field_nulls": null_checks[0], "observed_rows_without_canonical_response": null_checks[1],
+        "eligibility_rules": {
+            "GSHS": "Rows only from the seven components where the primary items were administered.",
+            "YRBS": "All respondents in each verified national annual full table; blank source responses remain unknown missing.",
+            "NSDUH": "CATAG2=1 (official label: 12-17 years old); only YUSUITHK and YUSUIPLN are locally available.",
+        },
+        "excluded_item_instances": [
+            r["item_version_id"] for r in item_rows
+            if r["survey"] == "NSDUH" and r["source_variable"] == "YUSUICTRY"
+        ],
+        "gate_boundary": "No human reviewer fields are inferred. Four NSDUH attempt items have no response rows because the fields are absent from local public-use microdata.",
+    }
+    MANIFEST.write_text(json.dumps(manifest, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    REPORT.write_text(
+        "# Primary-outcome response long-table audit\n\n"
+        "Status: **provisional; structural validation passed**.\n\n"
+        f"- rows: {manifest['rows']:,}\n"
+        f"- unique respondent × item keys: {manifest['unique_response_keys']:,}\n"
+        f"- item instances with local response data: {manifest['item_instances_with_rows']} of 84\n"
+        f"- rows by survey: `{manifest['rows_by_survey']}`\n"
+        f"- observed/missing statuses: `{manifest['observed_status_counts']}`\n"
+        f"- SHA-256: `{manifest['sha256']}`\n\n"
+        "The output row totals equal counts independently derived from the seven GSHS components, all 17 YRBS annual full tables, and NSDUH respondents with CATAG2=1. Required identifiers/status fields are complete, respondent × item keys are unique, and every observed response has a canonical response. The four NSDUH attempt instances remain in the item bank without response rows because the public-use microdata omit those fields. Human double review is still required.\n",
+        encoding="utf-8",
+    )
+    print(json.dumps({k: manifest[k] for k in ["rows", "unique_response_keys", "item_instances_with_rows", "rows_by_survey", "observed_status_counts", "missing_type_counts", "sha256"]}, indent=2))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/construct_ontology.yaml

@@ -0,0 +1,36 @@
+schema_version: '1.0'
+status: provisional
+human_double_review_complete: false
+confirmatory_analysis_allowed: false
+constructs:
+  suicide_ideation:
+    label: suicidal ideation
+    definition: Serious consideration of attempting or trying to die by suicide during the stated time window.
+    primary_outcome: true
+    default_time_window: past 12 months
+    review_status: provisional
+  suicide_plan:
+    label: suicide plan
+    definition: Making a plan about how to attempt or die by suicide during the stated time window.
+    primary_outcome: true
+    default_time_window: past 12 months
+    review_status: provisional
+  suicide_attempt:
+    label: suicide attempt
+    definition: A self-reported attempt or try to die by suicide during the stated time window; frequency and binary forms remain distinct.
+    primary_outcome: true
+    default_time_window: past 12 months
+    review_status: provisional
+explicit_exclusions:
+  - self-harm without stated suicidal intent is a separate construct
+  - sadness or hopelessness is not a suicide-outcome substitute
+  - attempt-related injury and medical-treatment follow-ups are not substitutes for attempt occurrence
+  - derived binary fields are not independent administered items
+linking_rules:
+  - semantic similarity creates a candidate link only
+  - cross-survey equivalence requires population, wording, coding, and empirical invariance review
+  - no item family is an approved anchor at this stage
+missingness_rules:
+  - never recode unknown missing, refusal, don't know, or legitimate skip as a negative response without an explicit official rule
+  - retain explicit uncertainty as an observed category until the analysis protocol states otherwise
+  - keep raw response and any later binary derivation as separate fields with an auditable rule

research/stage1/gate1_acceptance_audit.json

@@ -0,0 +1,43 @@
+{
+  "gate": 1,
+  "status": "in_progress",
+  "checks": {
+    "item_bank": {
+      "passed": true,
+      "rows": 84
+    },
+    "response_dictionary": {
+      "passed": true,
+      "rows": 396
+    },
+    "survey_design": {
+      "passed": true,
+      "rows": 28
+    },
+    "construct_ontology": {
+      "passed": true
+    },
+    "responses_long": {
+      "passed": true,
+      "rows": 919863,
+      "items_with_rows": 80
+    },
+    "item_links": {
+      "passed": true,
+      "rows": 9,
+      "approved_anchors": 0
+    },
+    "source_conflicts": {
+      "passed": true,
+      "rows": 32,
+      "open": 11
+    },
+    "two_actual_human_reviewers": {
+      "passed": false,
+      "evidence_file": null
+    }
+  },
+  "unmet_requirements": [
+    "two_actual_human_reviewers"
+  ]
+}

research/stage1/gshs_primary_outcome_component_audit.md

@@ -0,0 +1,43 @@
+# GSHS primary-outcome component audit
+
+Version: 1.0 | Status: provisional | Generated: 2026-09-20
+
+## Result
+
+The selected GSHS master table contains 191 components and 673,499 rows. Exactly 7 components contain the three primary suicide outcomes; the remaining 184 contain no observed values in those six columns. Metadata row counts match the consolidated table for all components.
+
+The country questionnaires and ordinary codebooks identify three administered items: past-12-month suicide ideation, plan, and attempt frequency. The Binary Codebooks identify the `_b_` columns as binary indicators derived from those items. Row-level checks are exact: ideation and plan binary columns duplicate the raw yes/no coding, while attempt maps 0 times to No and one or more times to Yes. Therefore the `_b_` columns must not be counted as independent administered items.
+
+## Components with observed primary outcomes
+
+| Component | Country | Rows | Ideation nonmissing | Plan nonmissing | Attempt nonmissing | Direct local sources |
+|---|---|---:|---:|---:|---:|---|
+| `2023_MAR_GSHS_v01::mar_fez2023` | Morocco | 4,172 | 3,994 | 4,019 | 4,086 | local_questionnaire_and_codebooks_located |
+| `GHA_2022_GSHS_v01::gha_sek_tak2022` | Ghana | 3,796 | 3,645 | 3,645 | 3,682 | local_questionnaire_and_codebooks_located |
+| `IND_2022_GSHS_v01::ind_jaipur_2022` | India | 4,299 | 4,174 | 4,106 | 4,228 | local_questionnaire_and_codebooks_located |
+| `JAM_2023_GSHS_v01::jam_st_cath_2023` | Jamaica | 3,041 | 2,879 | 2,850 | 2,936 | local_questionnaire_and_codebooks_located |
+| `MNG_2023_GSHS_v01::mng2023` | Mongolia | 3,311 | 3,274 | 3,258 | 3,238 | local_questionnaire_and_codebooks_located |
+| `SLB_2023_GSHS_v01::slb_2023` | Solomon Islands | 1,995 | 1,890 | 1,953 | 1,963 | official_catalog_item_metadata_verified |
+| `WLF_2023_GSHS_v01::wlf_2023` | Wallis and Futuna | 919 | 894 | 907 | 905 | local_questionnaire_and_codebooks_located |
+
+## Representation checks
+
+| Raw item | Binary representation | Result | Observed mapping |
+|---|---|---|---|
+| `raw_mh_considersui` | `raw_mh_b_considersui` | passed | <missing>-><missing>: 652,749; 1->1: 4,854; 2->2: 15,896 |
+| `raw_mh_plansui` | `raw_mh_b_plansui` | passed | <missing>-><missing>: 652,761; 1->1: 4,363; 2->2: 16,375 |
+| `raw_mh_attemptsui` | `raw_mh_b_attemptsui` | passed | <missing>-><missing>: 652,461; 1->2: 16,732; 2->1: 2,457; 3->1: 1,139; 4->1: 325; 5->1: 385 |
+
+## Source boundary
+
+Local questionnaires plus raw and binary codebooks were located for 6 components: Ghana, India, Jamaica, Mongolia, Morocco, and Wallis and Futuna. For Solomon Islands, the official WHO catalog directly provides the three literal questions, response categories, case counts, universe, and sampling metadata. A country questionnaire file and administration-language evidence were not located, so those narrower provenance fields remain pending.
+
+Available English/French/Mongolian files establish wording evidence but do not by themselves prove the language administered to every respondent. Exact sampled ages/grades, component-specific eligibility, and canonical missing reasons also remain unresolved.
+
+## Gate 1 decision
+
+Gate 1 remains **in progress**. This audit resolves the 191-component coverage question, direct item-source coverage, and the raw-versus-`_b_` representation issue, but it does not satisfy all population/language/missing-rule or two-human-reviewer requirements. All records remain provisional and are not approved for confirmatory analysis or anchor construction.
+
+## Reproduction
+
+Run `research/stage1/audit_gshs_primary_outcome_components.py` in the project Python environment. The implementation streams the consolidated CSV and does not load it into pandas memory.

research/stage1/human_review_instructions.md

@@ -0,0 +1,17 @@
+# Gate 1 primary-outcome human review instructions
+
+Two **different actual people** must independently review all 84 rows. AI output, duplicated names, copied decisions, proxy signatures, or one person completing both files do not satisfy the workflow.
+
+1. Give `primary_outcome_review_reviewer_1.csv` and `primary_outcome_review_reviewer_2.csv` separately to the two reviewers. Do not give either reviewer the other person's decisions before both files are returned.
+2. Each reviewer checks the cited questionnaire/codebook evidence, wording, construct, population, response codes, skip logic, missing rules, and language evidence.
+3. Allowed decisions are `approve`, `approve_with_correction`, `reject`, and `needs_source`. Verification columns use only `yes` or `no`; language status uses `verified`, `provisional_accepted`, or `insufficient`.
+4. Every row must contain the same reviewer name, affiliation, ISO date, and exact independence attestation: `I am a human reviewer and completed this review independently.`
+5. After both files are returned, run the validator. Any non-approval, different decision, or correction enters the adjudication file. The adjudicator must be a real person and use the required attestation shown by validator errors.
+
+Validation command:
+
+```powershell
+.\.venv-research\Scripts\python.exe research/stage1/validate_human_reviews.py research/stage1/primary_outcome_review_reviewer_1.csv research/stage1/primary_outcome_review_reviewer_2.csv --adjudication research/stage1/primary_outcome_review_adjudication.csv
+```
+
+The blank templates are intentionally versioned. Completed files contain personal review attestations and should be inspected before committing or sharing.

research/stage1/import_yrbs_2021_2023.py

@@ -0,0 +1,152 @@
+"""Validate CDC fixed-width layouts and import quarantined YRBS 2021/2023 files."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+from collections import Counter
+from pathlib import Path
+
+import pyarrow as pa
+import pyarrow.parquet as pq
+
+
+ROOT = Path(__file__).resolve().parents[2]
+SOURCE = ROOT / "Dataset" / "YRBS_National_1991_2023"
+OUT = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "YRBS" / "full_by_year"
+STAGE1 = ROOT / "research" / "stage1"
+YEARS = {
+    2021: {
+        "raw": SOURCE / "raw" / "YRBS_2021_National.dat",
+        "archive": SOURCE / "source_archive" / "2021_cdc_download" / "XXH2021_YRBS_Data.dat",
+        "sas": SOURCE / "source_archive" / "2021_cdc_download" / "2021XXH-SAS-Input-Program.sas",
+        "items": ("Q26", "Q27", "Q28"),
+    },
+    2023: {
+        "raw": SOURCE / "raw" / "XXH2023_YRBS_Data.dat",
+        "archive": SOURCE / "source_archive" / "2023_cdc_download" / "XXH2023_YRBS_Data.dat",
+        "sas": SOURCE / "source_archive" / "2023_cdc_download" / "2023XXH-SAS-Input-Program.sas",
+        "items": ("Q27", "Q28", "Q29"),
+    },
+}
+
+
+def sha256(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for block in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(block)
+    return digest.hexdigest()
+
+
+def parse_layout(path: Path) -> list[dict[str, object]]:
+    text = path.read_text(encoding="utf-8-sig")
+    block = re.search(r"^\s*Input\s*$\s*(.*?);", text, flags=re.I | re.M | re.S)
+    if not block:
+        raise ValueError(f"No SAS Input block in {path}")
+    fields = []
+    pattern = re.compile(r"@(\d+)\s+([A-Za-z][A-Za-z0-9_]*)\s+(\$?)(\d+)(?:\.(\d+))?\.")
+    for start, name, character, width, decimals in pattern.findall(block.group(1)):
+        fields.append({
+            "start": int(start), "name": name.lower(), "width": int(width),
+            "character": bool(character), "decimals": int(decimals or 0),
+        })
+    if not fields:
+        raise ValueError(f"No fields parsed from {path}")
+    names = [str(field["name"]) for field in fields]
+    if len(names) != len(set(names)):
+        raise ValueError(f"Duplicate field names in {path}")
+    return fields
+
+
+def convert(raw: str, character: bool, decimals: int):
+    value = raw.strip()
+    if not value or value == ".":
+        return None
+    if character:
+        return value
+    if decimals or "." in value:
+        return float(value)
+    return int(value)
+
+
+def import_year(year: int, spec: dict[str, object]) -> dict[str, object]:
+    raw = spec["raw"]
+    archive = spec["archive"]
+    raw_hash = sha256(raw)
+    archive_hash = sha256(archive)
+    if raw_hash != archive_hash:
+        raise ValueError(f"{year}: raw file differs from CDC archive copy")
+    layout = parse_layout(spec["sas"])
+    columns = {str(field["name"]): [] for field in layout}
+    line_lengths = Counter()
+    with raw.open("r", encoding="ascii", newline="") as handle:
+        for source_row, line in enumerate(handle, start=1):
+            line = line.rstrip("\r\n")
+            line_lengths[len(line)] += 1
+            for field in layout:
+                start = int(field["start"]) - 1
+                width = int(field["width"])
+                columns[str(field["name"])].append(convert(line[start : start + width], bool(field["character"]), int(field["decimals"])))
+    if set(line_lengths) != {421}:
+        raise ValueError(f"{year}: unexpected record lengths {dict(line_lengths)}")
+    count = sum(line_lengths.values())
+    table_data = {"survey_year": [year] * count, "source_row": list(range(1, count + 1))}
+    table_data.update(columns)
+    table = pa.table(table_data)
+    output = OUT / f"yrbs_{year}_full.parquet"
+    pq.write_table(table, output, compression="zstd")
+    reread = pq.read_table(output)
+    if reread.num_rows != count or reread.num_columns != len(table_data):
+        raise ValueError(f"{year}: Parquet round-trip shape mismatch")
+    item_counts = {}
+    domains = {}
+    for item in spec["items"]:
+        values = columns[item.lower()]
+        counts = Counter("<missing>" if value is None else str(value) for value in values)
+        item_counts[item] = dict(sorted(counts.items()))
+        observed = {value for value in values if value is not None}
+        allowed = {"1", "2"} if item != spec["items"][2] else {"1", "2", "3", "4", "5"}
+        domains[item] = "passed" if {str(v) for v in observed} <= allowed else "failed"
+    design_nonmissing = {name: sum(value is not None for value in columns[name]) for name in ("weight", "stratum", "psu")}
+    return {
+        "year": year, "source_file": str(raw.relative_to(ROOT)).replace("\\", "/"),
+        "sas_layout": str(Path(spec["sas"]).relative_to(ROOT)).replace("\\", "/"),
+        "sha256": raw_hash, "archive_copy_identical": True, "record_length": 421,
+        "rows": count, "columns": len(table_data), "layout_fields": len(layout),
+        "output_file": str(output.relative_to(ROOT)).replace("\\", "/"),
+        "parquet_roundtrip": "passed", "primary_outcome_value_counts": item_counts,
+        "primary_outcome_domains": domains, "design_nonmissing": design_nonmissing,
+        "status": "import_validated",
+    }
+
+
+def main() -> None:
+    results = [import_year(year, spec) for year, spec in YEARS.items()]
+    audit = {
+        "schema_version": "1.0", "generated_on": "2026-09-20",
+        "status": "passed_for_import; still provisional for human item review",
+        "method": "Official CDC SAS fixed-width Input positions; raw/archive SHA-256 identity; record-length, domain, design-field, and Parquet round-trip checks.",
+        "years": results,
+        "decision": "YRBS 2021 and 2023 respondent files are released from import-layout quarantine. Primary-outcome items remain provisional pending two human reviewers.",
+    }
+    (STAGE1 / "yrbs_2021_2023_import_audit.json").write_text(json.dumps(audit, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    lines = ["# YRBS 2021/2023 official-layout import audit", "", audit["decision"], ""]
+    for result in results:
+        lines.extend([
+            f"## {result['year']}", "",
+            f"- rows × columns: {result['rows']:,} × {result['columns']}",
+            f"- raw file identical to archived CDC download: yes (`{result['sha256']}`)",
+            f"- fixed record length: {result['record_length']} bytes for every row",
+            f"- design completeness: `{result['design_nonmissing']}`",
+            f"- primary outcome domains: `{result['primary_outcome_domains']}`",
+            f"- output: `{result['output_file']}`", "",
+        ])
+    lines.extend(["## Boundary", "", "This resolves the import-layout quarantine only. It does not substitute for two actual human item reviewers or approve design-based variance estimation.", ""])
+    (STAGE1 / "yrbs_2021_2023_import_audit.md").write_text("\n".join(lines), encoding="utf-8")
+    print(json.dumps(audit, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/input_structure_audit.json

@@ -27,7 +27,7 @@
     },
     "YRBS_selected_1991_2019": {
       "path": "Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/yrbs_1991_2019_selected.parquet",
-      "bytes": 2576853,
+      "bytes": 2595834,
       "rows": 217341,
       "columns": 79,
       "row_groups": 1,
@@ -49,9 +49,9 @@
         "2019": 13677
       },
       "design_non_null": {
-        "weight": 210769,
+        "weight": 217340,
-        "stratum": 188898,
+        "stratum": 217340,
-        "psu": 188898
+        "psu": 217340
       },
       "design_non_null_by_year": {
         "1991": {
@@ -120,10 +120,14 @@
           "psu": 15624
         },
         "2017": {
-          "weight": 13026
+          "weight": 14765,
+          "stratum": 14765,
+          "psu": 14765
         },
         "2019": {
-          "weight": 8845
+          "weight": 13677,
+          "stratum": 13677,
+          "psu": 13677
         }
       },
       "design_positive_by_year": {
@@ -193,10 +197,14 @@
           "psu": 15624
         },
         "2017": {
-          "weight": 13026
+          "weight": 14765,
+          "stratum": 14765,
+          "psu": 14765
         },
         "2019": {
-          "weight": 8845
+          "weight": 13677,
+          "stratum": 13677,
+          "psu": 13677
         }
       },
       "required_columns_present": true,
@@ -386,9 +394,10 @@
     }
   },
   "limitations": [
-    "YRBS 2021 and 2023 are not included in the selected analytic Parquet and remain quarantined pending layout verification.",
+    "YRBS 2021 and 2023 have validated annual full Parquet files but are not appended to the legacy 1991-2019 selected table.",
-    "GSHS design fields are candidates and require survey-specific source verification.",
+    "One YRBS 1997 record lacks weight, stratum, and PSU; 2017/2019 design fields were restored from official fixed-width locations.",
-    "NSDUH year-specific weight selection and variance usage require confirmation against the combined-file guide.",
+    "GSHS design-field identities are verified for the seven primary-outcome components; cross-component identifiers require namespacing.",
+    "NSDUH uses ANALWT2_C1 for single-year estimates; C2/C3/C4 are exact 2/3/4-year pooled annual-average weights. Domain variance analysis must retain the full design.",
     "This audit does not approve item wording, response recodes, missingness rules, constructs, or cross-survey links."
   ]
 }

research/stage1/item_bank.csv

@@ -0,0 +1,85 @@
+item_version_id,item_family_id,survey_id,component_id,survey,country,year,scope,population,source_variable,question_text,text_hash,construct,time_window,response_type,language,questionnaire_version,data_availability,analysis_eligibility,source_file,source_url,page_or_section,reviewer_1,reviewer_2,review_status,notes
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::2023_MAR_GSHS_v01,2023_MAR_GSHS_v01::mar_fez2023,GSHS,Morocco,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,French; English reference; actual administered language not established,2023_MAR_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::2023_MAR_GSHS_v01,2023_MAR_GSHS_v01::mar_fez2023,GSHS,Morocco,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,French; English reference; actual administered language not established,2023_MAR_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::2023_MAR_GSHS_v01,2023_MAR_GSHS_v01::mar_fez2023,GSHS,Morocco,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,French; English reference; actual administered language not established,2023_MAR_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::GHA_2022_GSHS_v01,GHA_2022_GSHS_v01::gha_sek_tak2022,GSHS,Ghana,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,English; actual administered language not established,GHA_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::GHA_2022_GSHS_v01,GHA_2022_GSHS_v01::gha_sek_tak2022,GSHS,Ghana,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English; actual administered language not established,GHA_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::GHA_2022_GSHS_v01,GHA_2022_GSHS_v01::gha_sek_tak2022,GSHS,Ghana,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,English; actual administered language not established,GHA_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::IND_2022_GSHS_v01,IND_2022_GSHS_v01::ind_jaipur_2022,GSHS,India,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,English; actual administered language not established,IND_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::IND_2022_GSHS_v01,IND_2022_GSHS_v01::ind_jaipur_2022,GSHS,India,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English; actual administered language not established,IND_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::IND_2022_GSHS_v01,IND_2022_GSHS_v01::ind_jaipur_2022,GSHS,India,2022,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,English; actual administered language not established,IND_2022_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::JAM_2023_GSHS_v01,JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,Jamaica,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,English; actual administered language not established,JAM_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::JAM_2023_GSHS_v01,JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,Jamaica,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English; actual administered language not established,JAM_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::JAM_2023_GSHS_v01,JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,Jamaica,2023,component,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,English; actual administered language not established,JAM_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::MNG_2023_GSHS_v01,MNG_2023_GSHS_v01::mng2023,GSHS,Mongolia,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,English; Mongolian; actual administered language not established,MNG_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::MNG_2023_GSHS_v01,MNG_2023_GSHS_v01::mng2023,GSHS,Mongolia,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English; Mongolian; actual administered language not established,MNG_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::MNG_2023_GSHS_v01,MNG_2023_GSHS_v01::mng2023,GSHS,Mongolia,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,English; Mongolian; actual administered language not established,MNG_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::SLB_2023_GSHS_v01,SLB_2023_GSHS_v01::slb_2023,GSHS,Solomon Islands,2023,component,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,English catalog literal-question metadata; actual administered language not established,SLB_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::SLB_2023_GSHS_v01,SLB_2023_GSHS_v01::slb_2023,GSHS,Solomon Islands,2023,component,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English catalog literal-question metadata; actual administered language not established,SLB_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::SLB_2023_GSHS_v01,SLB_2023_GSHS_v01::slb_2023,GSHS,Solomon Islands,2023,component,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,English catalog literal-question metadata; actual administered language not established,SLB_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,GSHS::suicide_ideation::past_12_months,GSHS::WLF_2023_GSHS_v01,WLF_2023_GSHS_v01::wlf_2023,GSHS,Wallis and Futuna,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_considersui,"During the past 12 months, did you seriously consider attempting suicide?",32ff301e6e09c2a1a19632bafd61441229513d9f8b828d6e92e0918e0580df46,suicide_ideation,past 12 months,binary,French; English reference; actual administered language not established,WLF_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,GSHS::suicide_plan::past_12_months,GSHS::WLF_2023_GSHS_v01,WLF_2023_GSHS_v01::wlf_2023,GSHS,Wallis and Futuna,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_plansui,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,French; English reference; actual administered language not established,WLF_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,GSHS::suicide_attempt::past_12_months,GSHS::WLF_2023_GSHS_v01,WLF_2023_GSHS_v01::wlf_2023,GSHS,Wallis and Futuna,2023,national,school-attending students; exact sampled ages/grades remain pending component source review,raw_mh_attemptsui,"During the past 12 months, how many times did you attempt suicide?",490c698e57394e23acab27853ed35a385a3999b92694015bcd0e940542b30f07,suicide_attempt,past 12 months,ordinal_frequency,French; English reference; actual administered language not established,WLF_2023_GSHS_v01,available_in_local_component,provisional_pipeline_development_only,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,,,provisional,"Raw administered item only; the raw_mh_b_* field is a derived/duplicate representation, not another administered item."
+YRBS::1991::Q19,YRBS::suicide_ideation::past_12_months,YRBS::1991,YRBS_NATIONAL::1991,YRBS,United States,1991,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q19,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1991,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1991::Q20,YRBS::suicide_plan::past_12_months,YRBS::1991,YRBS_NATIONAL::1991,YRBS,United States,1991,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q20,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1991,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1991::Q21,YRBS::suicide_attempt::past_12_months,YRBS::1991,YRBS_NATIONAL::1991,YRBS,United States,1991,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q21,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1991,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1993::Q24,YRBS::suicide_ideation::past_12_months,YRBS::1993,YRBS_NATIONAL::1993,YRBS,United States,1993,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1993,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1993::Q25,YRBS::suicide_plan::past_12_months,YRBS::1993,YRBS_NATIONAL::1993,YRBS,United States,1993,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1993,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1993::Q26,YRBS::suicide_attempt::past_12_months,YRBS::1993,YRBS_NATIONAL::1993,YRBS,United States,1993,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1993,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1995::Q22,YRBS::suicide_ideation::past_12_months,YRBS::1995,YRBS_NATIONAL::1995,YRBS,United States,1995,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q22,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1995,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1995::Q23,YRBS::suicide_plan::past_12_months,YRBS::1995,YRBS_NATIONAL::1995,YRBS,United States,1995,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q23,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1995,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1995::Q24,YRBS::suicide_attempt::past_12_months,YRBS::1995,YRBS_NATIONAL::1995,YRBS,United States,1995,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1995,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1997::Q22,YRBS::suicide_ideation::past_12_months,YRBS::1997,YRBS_NATIONAL::1997,YRBS,United States,1997,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q22,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1997,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1997::Q23,YRBS::suicide_plan::past_12_months,YRBS::1997,YRBS_NATIONAL::1997,YRBS,United States,1997,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q23,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1997,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1997::Q24,YRBS::suicide_attempt::past_12_months,YRBS::1997,YRBS_NATIONAL::1997,YRBS,United States,1997,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1997,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1999::Q23,YRBS::suicide_ideation::past_12_months,YRBS::1999,YRBS_NATIONAL::1999,YRBS,United States,1999,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q23,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1999,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1999::Q24,YRBS::suicide_plan::past_12_months,YRBS::1999,YRBS_NATIONAL::1999,YRBS,United States,1999,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1999,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::1999::Q25,YRBS::suicide_attempt::past_12_months,YRBS::1999,YRBS_NATIONAL::1999,YRBS,United States,1999,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 1999,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2001::Q24,YRBS::suicide_ideation::past_12_months,YRBS::2001,YRBS_NATIONAL::2001,YRBS,United States,2001,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2001,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2001::Q25,YRBS::suicide_plan::past_12_months,YRBS::2001,YRBS_NATIONAL::2001,YRBS,United States,2001,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2001,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2001::Q26,YRBS::suicide_attempt::past_12_months,YRBS::2001,YRBS_NATIONAL::2001,YRBS,United States,2001,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2001,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2003::Q24,YRBS::suicide_ideation::past_12_months,YRBS::2003,YRBS_NATIONAL::2003,YRBS,United States,2003,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2003,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2003::Q25,YRBS::suicide_plan::past_12_months,YRBS::2003,YRBS_NATIONAL::2003,YRBS,United States,2003,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2003,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2003::Q26,YRBS::suicide_attempt::past_12_months,YRBS::2003,YRBS_NATIONAL::2003,YRBS,United States,2003,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2003,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2005::Q24,YRBS::suicide_ideation::past_12_months,YRBS::2005,YRBS_NATIONAL::2005,YRBS,United States,2005,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2005,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2005::Q25,YRBS::suicide_plan::past_12_months,YRBS::2005,YRBS_NATIONAL::2005,YRBS,United States,2005,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2005,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2005::Q26,YRBS::suicide_attempt::past_12_months,YRBS::2005,YRBS_NATIONAL::2005,YRBS,United States,2005,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2005,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2007::Q24,YRBS::suicide_ideation::past_12_months,YRBS::2007,YRBS_NATIONAL::2007,YRBS,United States,2007,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2007,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2007::Q25,YRBS::suicide_plan::past_12_months,YRBS::2007,YRBS_NATIONAL::2007,YRBS,United States,2007,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2007,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2007::Q26,YRBS::suicide_attempt::past_12_months,YRBS::2007,YRBS_NATIONAL::2007,YRBS,United States,2007,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2007,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2009::Q24,YRBS::suicide_ideation::past_12_months,YRBS::2009,YRBS_NATIONAL::2009,YRBS,United States,2009,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q24,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2009,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2009::Q25,YRBS::suicide_plan::past_12_months,YRBS::2009,YRBS_NATIONAL::2009,YRBS,United States,2009,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2009,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2009::Q26,YRBS::suicide_attempt::past_12_months,YRBS::2009,YRBS_NATIONAL::2009,YRBS,United States,2009,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2009,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2011::Q25,YRBS::suicide_ideation::past_12_months,YRBS::2011,YRBS_NATIONAL::2011,YRBS,United States,2011,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q25,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2011,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2011::Q26,YRBS::suicide_plan::past_12_months,YRBS::2011,YRBS_NATIONAL::2011,YRBS,United States,2011,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2011,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2011::Q27,YRBS::suicide_attempt::past_12_months,YRBS::2011,YRBS_NATIONAL::2011,YRBS,United States,2011,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2011,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2013::Q27,YRBS::suicide_ideation::past_12_months,YRBS::2013,YRBS_NATIONAL::2013,YRBS,United States,2013,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2013,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2013::Q28,YRBS::suicide_plan::past_12_months,YRBS::2013,YRBS_NATIONAL::2013,YRBS,United States,2013,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2013,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2013::Q29,YRBS::suicide_attempt::past_12_months,YRBS::2013,YRBS_NATIONAL::2013,YRBS,United States,2013,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q29,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2013,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2015::Q27,YRBS::suicide_ideation::past_12_months,YRBS::2015,YRBS_NATIONAL::2015,YRBS,United States,2015,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2015,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2015::Q28,YRBS::suicide_plan::past_12_months,YRBS::2015,YRBS_NATIONAL::2015,YRBS,United States,2015,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2015,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2015::Q29,YRBS::suicide_attempt::past_12_months,YRBS::2015,YRBS_NATIONAL::2015,YRBS,United States,2015,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q29,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2015,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2017::Q26,YRBS::suicide_ideation::past_12_months,YRBS::2017,YRBS_NATIONAL::2017,YRBS,United States,2017,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2017,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2017::Q27,YRBS::suicide_plan::past_12_months,YRBS::2017,YRBS_NATIONAL::2017,YRBS,United States,2017,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2017,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2017::Q28,YRBS::suicide_attempt::past_12_months,YRBS::2017,YRBS_NATIONAL::2017,YRBS,United States,2017,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2017,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2019::Q26,YRBS::suicide_ideation::past_12_months,YRBS::2019,YRBS_NATIONAL::2019,YRBS,United States,2019,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2019,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2019::Q27,YRBS::suicide_plan::past_12_months,YRBS::2019,YRBS_NATIONAL::2019,YRBS,United States,2019,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2019,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2019::Q28,YRBS::suicide_attempt::past_12_months,YRBS::2019,YRBS_NATIONAL::2019,YRBS,United States,2019,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2019,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2021::Q26,YRBS::suicide_ideation::past_12_months,YRBS::2021,YRBS_NATIONAL::2021,YRBS,United States,2021,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q26,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2021,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2021::Q27,YRBS::suicide_plan::past_12_months,YRBS::2021,YRBS_NATIONAL::2021,YRBS,United States,2021,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2021,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2021::Q28,YRBS::suicide_attempt::past_12_months,YRBS::2021,YRBS_NATIONAL::2021,YRBS,United States,2021,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2021,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2023::Q27,YRBS::suicide_ideation::past_12_months,YRBS::2023,YRBS_NATIONAL::2023,YRBS,United States,2023,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q27,"During the past 12 months, did you ever seriously consider attempting suicide?",0b2df6b623cc9cd5521af275980c1b6a582eca3a15b67906ec05e822b0a67973,suicide_ideation,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2023,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2023::Q28,YRBS::suicide_plan::past_12_months,YRBS::2023,YRBS_NATIONAL::2023,YRBS,United States,2023,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q28,"During the past 12 months, did you make a plan about how you would attempt suicide?",f29777fd4c84bd3678e8a8e4ce69ee7e8ef49e0566c9ad5cf859e5e501ab0505,suicide_plan,past 12 months,binary,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2023,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+YRBS::2023::Q29,YRBS::suicide_attempt::past_12_months,YRBS::2023,YRBS_NATIONAL::2023,YRBS,United States,2023,national,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,Q29,"During the past 12 months, how many times did you actually attempt suicide?",99ac037649ef18c5d98cfef87c554969bb89198e79635ffabdca871818c07d03,suicide_attempt,past 12 months,ordinal_frequency,English questionnaire source; actual accommodation/language coverage not established by this audit,YRBS national questionnaire 2023,available_full_table,provisional_pipeline_development_only,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,provisional,blank/null retained as unresolved missing; annual guide reports Missing but does not distinguish reason
+NSDUH::2021::YUSUITHK,NSDUH::suicide_ideation::past_12_months,NSDUH::2021,NSDUH_YOUTH::2021,NSDUH,United States,2021,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUITHK,"The next few questions are about thoughts of suicide. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself ?",655dea94026d96937a368ed77fad63361078c7fecfcc1cd0bee8ae3b62cb8267,suicide_ideation,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2021 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2021::YUSUIPLN,NSDUH::suicide_plan::past_12_months,NSDUH::2021,NSDUH_YOUTH::2021,NSDUH,United States,2021,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUIPLN,"During the past 12 months, did you make any plans to kill yourself?",66e41d31c31186b2c4804776d2c0d867ec70fb71113001338680724e9aef05d1,suicide_plan,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2021 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2022::YUSUITHK,NSDUH::suicide_ideation::past_12_months,NSDUH::2022,NSDUH_YOUTH::2022,NSDUH,United States,2022,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUITHK,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",2e47c89fadeeb1ba172a1c3f701e18bbd0f9918dfd3042bb133777e39c9d6bf5,suicide_ideation,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2022 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2022::YUSUIPLN,NSDUH::suicide_plan::past_12_months,NSDUH::2022,NSDUH_YOUTH::2022,NSDUH,United States,2022,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUIPLN,"During the past 12 months, did you make any plans to kill yourself?",66e41d31c31186b2c4804776d2c0d867ec70fb71113001338680724e9aef05d1,suicide_plan,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2022 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2023::YUSUITHK,NSDUH::suicide_ideation::past_12_months,NSDUH::2023,NSDUH_YOUTH::2023,NSDUH,United States,2023,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUITHK,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",2e47c89fadeeb1ba172a1c3f701e18bbd0f9918dfd3042bb133777e39c9d6bf5,suicide_ideation,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2023 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2023::YUSUIPLN,NSDUH::suicide_plan::past_12_months,NSDUH::2023,NSDUH_YOUTH::2023,NSDUH,United States,2023,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUIPLN,"During the past 12 months, did you make any plans to kill yourself?",66e41d31c31186b2c4804776d2c0d867ec70fb71113001338680724e9aef05d1,suicide_plan,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2023 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2024::YUSUITHK,NSDUH::suicide_ideation::past_12_months,NSDUH::2024,NSDUH_YOUTH::2024,NSDUH,United States,2024,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUITHK,"Note: Beginning in 2022, questions YSUI01, YSUI02, YSUI03, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",7a688bc54040f6ff682b5b8194237060f829dc16cf91cf448865a76d7d7c3100,suicide_ideation,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2024 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2024::YUSUIPLN,NSDUH::suicide_plan::past_12_months,NSDUH::2024,NSDUH_YOUTH::2024,NSDUH,United States,2024,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUIPLN,"During the past 12 months, did you make any plans to kill yourself?",66e41d31c31186b2c4804776d2c0d867ec70fb71113001338680724e9aef05d1,suicide_plan,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2024 youth module,available_in_local_public_use_table,provisional_pipeline_development_only,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,,,provisional,Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified.
+NSDUH::2021::YUSUICTRY,NSDUH::suicide_attempt::past_12_months,NSDUH::2021,NSDUH_YOUTH::2021,NSDUH,United States,2021,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUICTRY,"During the past 12 months, did you try to kill yourself?",f870f158cf7b2a15b314ea5a07674ea5e3ca14a2155652cddb7f2f50806666e8,suicide_attempt,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2021 youth module,administered_but_not_available_in_local_public_use_package,not_analyzable_without_authorized_source,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,,,provisional,"Asked of all adolescents aged 12–17, regardless of ideation response. Current local public-use schema omits the raw and recoded attempt variables; this row is not analyzable without an authorized source."
+NSDUH::2022::YUSUICTRY,NSDUH::suicide_attempt::past_12_months,NSDUH::2022,NSDUH_YOUTH::2022,NSDUH,United States,2022,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUICTRY,"During the past 12 months, did you try to kill yourself?",f870f158cf7b2a15b314ea5a07674ea5e3ca14a2155652cddb7f2f50806666e8,suicide_attempt,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2022 youth module,administered_but_not_available_in_local_public_use_package,not_analyzable_without_authorized_source,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,,,provisional,"Asked of all adolescents aged 12–17, regardless of ideation response. Current local public-use schema omits the raw and recoded attempt variables; this row is not analyzable without an authorized source."
+NSDUH::2023::YUSUICTRY,NSDUH::suicide_attempt::past_12_months,NSDUH::2023,NSDUH_YOUTH::2023,NSDUH,United States,2023,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUICTRY,"During the past 12 months, did you try to kill yourself?",f870f158cf7b2a15b314ea5a07674ea5e3ca14a2155652cddb7f2f50806666e8,suicide_attempt,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2023 youth module,administered_but_not_available_in_local_public_use_package,not_analyzable_without_authorized_source,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,,,provisional,"Asked of all adolescents aged 12–17, regardless of ideation response. Current local public-use schema omits the raw and recoded attempt variables; this row is not analyzable without an authorized source."
+NSDUH::2024::YUSUICTRY,NSDUH::suicide_attempt::past_12_months,NSDUH::2024,NSDUH_YOUTH::2024,NSDUH,United States,2024,national household survey youth module,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,YUSUICTRY,"During the past 12 months, did you try to kill yourself?",f870f158cf7b2a15b314ea5a07674ea5e3ca14a2155652cddb7f2f50806666e8,suicide_attempt,past 12 months,categorical_binary_with_explicit_uncertainty,English source metadata; administered-language/accommodation coverage not established,NSDUH 2024 youth module,administered_but_not_available_in_local_public_use_package,not_analyzable_without_authorized_source,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,,,provisional,"Asked of all adolescents aged 12–17, regardless of ideation response. Current local public-use schema omits the raw and recoded attempt variables; this row is not analyzable without an authorized source."

research/stage1/item_links.csv

@@ -0,0 +1,10 @@
+item_pair,left_item_family_id,right_item_family_id,relation_type,semantic_evidence,population_overlap,anchor_status,exclusion_reason,review_status
+GSHS::suicide_ideation <-> YRBS::suicide_ideation,GSHS::suicide_ideation::past_12_months,YRBS::suicide_ideation::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+GSHS::suicide_ideation <-> NSDUH::suicide_ideation,GSHS::suicide_ideation::past_12_months,NSDUH::suicide_ideation::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+YRBS::suicide_ideation <-> NSDUH::suicide_ideation,YRBS::suicide_ideation::past_12_months,NSDUH::suicide_ideation::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+GSHS::suicide_plan <-> YRBS::suicide_plan,GSHS::suicide_plan::past_12_months,YRBS::suicide_plan::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+GSHS::suicide_plan <-> NSDUH::suicide_plan,GSHS::suicide_plan::past_12_months,NSDUH::suicide_plan::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+YRBS::suicide_plan <-> NSDUH::suicide_plan,YRBS::suicide_plan::past_12_months,NSDUH::suicide_plan::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+GSHS::suicide_attempt <-> YRBS::suicide_attempt,GSHS::suicide_attempt::past_12_months,YRBS::suicide_attempt::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+GSHS::suicide_attempt <-> NSDUH::suicide_attempt,GSHS::suicide_attempt::past_12_months,NSDUH::suicide_attempt::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional
+YRBS::suicide_attempt <-> NSDUH::suicide_attempt,YRBS::suicide_attempt::past_12_months,NSDUH::suicide_attempt::past_12_months,conceptual_candidate_only,"same provisional construct and 12-month window; wording, response form, population, and mode differ",adolescent age overlap exists but sampling frames differ,not_approved,"No empirical invariance, coadministration, or human double-review evidence yet.",provisional

research/stage1/nsduh_youth_attempt_source_audit.json

@@ -0,0 +1,97 @@
+{
+  "schema_version": "1.0",
+  "generated_on": "2026-09-20",
+  "status": "provisional_source_verification",
+  "workflow_stage": 1,
+  "official_sources": [
+    {
+      "year": 2021,
+      "type": "restricted_use_codebook",
+      "url": "https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf",
+      "verified_claim": "YSUI03 maps to YUSUICTRY and asks whether the youth tried to kill themself in the past 12 months."
+    },
+    {
+      "year": 2022,
+      "type": "restricted_use_codebook",
+      "url": "https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf",
+      "verified_claim": "YSUI03/YUSUICTRY is the attempt item; YSUI04/YUSUICMED and YSUI05/YUSUIHOSP are conditional follow-ups."
+    },
+    {
+      "year": 2023,
+      "type": "restricted_use_codebook",
+      "url": "https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf",
+      "verified_claim": "YSUI03 maps to YUSUICTRY; the analytic recode is documented as YUSUICTRYYR while composite formulas reference YUSUITRYYR, requiring name reconciliation before restricted-use analysis."
+    },
+    {
+      "year": 2024,
+      "type": "questionnaire_web_specification",
+      "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf",
+      "verified_claim": "YSUI03 is asked of respondents aged 12–17; YSUI04 is routed only when YSUI03=1 and YSUI05 only when YSUI04=1."
+    },
+    {
+      "year": 2024,
+      "type": "methodological_summary",
+      "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt56485/2024-nsduh-method-summ-defs/2024-nsduh-method-summ-defs/2024-nsduh-method-summary-defs.htm",
+      "verified_claim": "All adolescents aged 12–17 are asked plan and attempt regardless of serious-thought response; youth variables are not statistically imputed."
+    },
+    {
+      "year": 2024,
+      "type": "public_use_data_users_guide",
+      "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt56775/2024-nsduh-puf-data-users-guide.pdf",
+      "verified_claim": "The past-year youth suicide-attempt variable YUSUITRYYR is excluded from the public-use file due to disclosure risk."
+    }
+  ],
+  "local_availability": [
+    {
+      "variable": "YUSUICTRY",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUITRYYR",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUICTRYYR",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUICMED",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUIMEDYR",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUIHOSP",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    },
+    {
+      "variable": "YUSUIHOSYR",
+      "in_complete_dictionary": false,
+      "in_full_parquet": false,
+      "in_selected_parquet": false
+    }
+  ],
+  "verified_item_logic": {
+    "YSUI03": "Asked of all respondents aged 12–17; not conditional on YSUI01 or YSUI02.",
+    "YSUI04": "Asked only if YSUI03=1; medical-attention follow-up.",
+    "YSUI05": "Asked only if YSUI04=1; overnight-hospital follow-up.",
+    "module_location": "Youth mental health service utilization in 2021; youth experiences from 2022 onward."
+  },
+  "conclusion": "The attempt item was administered, but no raw, recoded, medical-attention, or hospital-follow-up youth-attempt fields are available in the current local public-use package.",
+  "analysis_decision": "Do not use NSDUH as respondent-level external validation for youth suicide attempt with the current data. Retain ideation and plan only; pursue restricted-use access or an aggregate-only alternative if attempt validation is required.",
+  "remaining_review": "Direct PDF page rendering was blocked by HTTP 403. Exact indexed official text and HTML were verified; two-human-reviewer sign-off remains outstanding."
+}

research/stage1/nsduh_youth_attempt_source_audit.md

@@ -0,0 +1,41 @@
+# NSDUH youth suicide-attempt source audit
+
+Version: 1.0 | Status: provisional source verification | Date: 2026-09-20
+
+## Result
+
+Official NSDUH materials verify that `YSUI03` asks adolescents aged 12–17 whether they tried to kill themselves in the past 12 months. The source variable is `YUSUICTRY`; `YSUI04`/`YUSUICMED` and `YSUI05`/`YUSUIHOSP` are conditional severity follow-ups. Plan and attempt are asked regardless of the answer to the ideation item.
+
+None of the attempt or follow-up fields is present in the current local public-use dictionary or Parquet schemas:
+
+| Variable | Complete dictionary | Full Parquet | Selected Parquet |
+|---|---:|---:|---:|
+| `YUSUICTRY` | false | false | false |
+| `YUSUITRYYR` | false | false | false |
+| `YUSUICTRYYR` | false | false | false |
+| `YUSUICMED` | false | false | false |
+| `YUSUIMEDYR` | false | false | false |
+| `YUSUIHOSP` | false | false | false |
+| `YUSUIHOSYR` | false | false | false |
+
+The 2024 public-use guide explicitly states that the recoded youth attempt variable `YUSUITRYYR` is excluded because of disclosure risk. The current local package is sourced from the official public-use DAS API, which explains why its complete dictionary ends after youth ideation and plan rather than proving the attempt item was never administered.
+
+## Stage 1 decision
+
+- Register `YSUI03`/`YUSUICTRY` as an administered, source-verified, but locally unavailable candidate.
+- Do not derive attempt from ideation wording, plan responses, COVID-conditioned questions, or medical/hospital follow-ups.
+- With current microdata, NSDUH may validate youth ideation and plan only. Youth attempt requires authorized restricted-use data or a separately designed aggregate-data analysis.
+- Keep all records `provisional`; direct PDF page rendering and two-human-reviewer approval remain outstanding.
+
+## Official sources
+
+- [2021 restricted-use codebook](https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf)
+- [2022 restricted-use codebook](https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf)
+- [2023 restricted-use codebook](https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf)
+- [2024 questionnaire web specification](https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf)
+- [2024 methodological summary](https://www.samhsa.gov/data/sites/default/files/reports/rpt56485/2024-nsduh-method-summ-defs/2024-nsduh-method-summ-defs/2024-nsduh-method-summary-defs.htm)
+- [2024 public-use data users' guide](https://www.samhsa.gov/data/sites/default/files/reports/rpt56775/2024-nsduh-puf-data-users-guide.pdf)
+
+## Reproducibility and limitation
+
+`verify_nsduh_youth_attempt.py` rechecks the repository-local dictionary and both Parquet schemas. SAMHSA's PDF endpoints returned HTTP 403 to direct readers during this action, so the official documents were verified through their indexed official text and the accessible SAMHSA HTML material; visual page-level PDF verification is not claimed.

research/stage1/primary_outcome_human_review_queue.csv

@@ -0,0 +1,85 @@
+item_version_id,survey,component_id,construct,question_text,response_dictionary_rows,population,language,source_file,source_url,page_or_section,reviewer_1,reviewer_1_decision,reviewer_1_date,reviewer_2,reviewer_2_decision,reviewer_2_date,adjudicator,adjudication,review_status,review_instructions
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1991::Q19,YRBS,YRBS_NATIONAL::1991,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1991::Q20,YRBS,YRBS_NATIONAL::1991,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1991::Q21,YRBS,YRBS_NATIONAL::1991,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1993::Q24,YRBS,YRBS_NATIONAL::1993,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1993::Q25,YRBS,YRBS_NATIONAL::1993,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1993::Q26,YRBS,YRBS_NATIONAL::1993,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1995::Q22,YRBS,YRBS_NATIONAL::1995,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1995::Q23,YRBS,YRBS_NATIONAL::1995,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1995::Q24,YRBS,YRBS_NATIONAL::1995,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1997::Q22,YRBS,YRBS_NATIONAL::1997,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1997::Q23,YRBS,YRBS_NATIONAL::1997,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1997::Q24,YRBS,YRBS_NATIONAL::1997,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1999::Q23,YRBS,YRBS_NATIONAL::1999,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1999::Q24,YRBS,YRBS_NATIONAL::1999,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::1999::Q25,YRBS,YRBS_NATIONAL::1999,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2001::Q24,YRBS,YRBS_NATIONAL::2001,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2001::Q25,YRBS,YRBS_NATIONAL::2001,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2001::Q26,YRBS,YRBS_NATIONAL::2001,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2003::Q24,YRBS,YRBS_NATIONAL::2003,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2003::Q25,YRBS,YRBS_NATIONAL::2003,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2003::Q26,YRBS,YRBS_NATIONAL::2003,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2005::Q24,YRBS,YRBS_NATIONAL::2005,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2005::Q25,YRBS,YRBS_NATIONAL::2005,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2005::Q26,YRBS,YRBS_NATIONAL::2005,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2007::Q24,YRBS,YRBS_NATIONAL::2007,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2007::Q25,YRBS,YRBS_NATIONAL::2007,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2007::Q26,YRBS,YRBS_NATIONAL::2007,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2009::Q24,YRBS,YRBS_NATIONAL::2009,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2009::Q25,YRBS,YRBS_NATIONAL::2009,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2009::Q26,YRBS,YRBS_NATIONAL::2009,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2011::Q25,YRBS,YRBS_NATIONAL::2011,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2011::Q26,YRBS,YRBS_NATIONAL::2011,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2011::Q27,YRBS,YRBS_NATIONAL::2011,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2013::Q27,YRBS,YRBS_NATIONAL::2013,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2013::Q28,YRBS,YRBS_NATIONAL::2013,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2013::Q29,YRBS,YRBS_NATIONAL::2013,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2015::Q27,YRBS,YRBS_NATIONAL::2015,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2015::Q28,YRBS,YRBS_NATIONAL::2015,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2015::Q29,YRBS,YRBS_NATIONAL::2015,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2017::Q26,YRBS,YRBS_NATIONAL::2017,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2017::Q27,YRBS,YRBS_NATIONAL::2017,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2017::Q28,YRBS,YRBS_NATIONAL::2017,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2019::Q26,YRBS,YRBS_NATIONAL::2019,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2019::Q27,YRBS,YRBS_NATIONAL::2019,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2019::Q28,YRBS,YRBS_NATIONAL::2019,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2021::Q26,YRBS,YRBS_NATIONAL::2021,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2021::Q27,YRBS,YRBS_NATIONAL::2021,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2021::Q28,YRBS,YRBS_NATIONAL::2021,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2023::Q27,YRBS,YRBS_NATIONAL::2023,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2023::Q28,YRBS,YRBS_NATIONAL::2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+YRBS::2023::Q29,YRBS,YRBS_NATIONAL::2023,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2021::YUSUITHK,NSDUH,NSDUH_YOUTH::2021,suicide_ideation,"The next few questions are about thoughts of suicide. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself ?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2021::YUSUIPLN,NSDUH,NSDUH_YOUTH::2021,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2022::YUSUITHK,NSDUH,NSDUH_YOUTH::2022,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2022::YUSUIPLN,NSDUH,NSDUH_YOUTH::2022,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2023::YUSUITHK,NSDUH,NSDUH_YOUTH::2023,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2023::YUSUIPLN,NSDUH,NSDUH_YOUTH::2023,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2024::YUSUITHK,NSDUH,NSDUH_YOUTH::2024,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YSUI02, YSUI03, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2024::YUSUIPLN,NSDUH,NSDUH_YOUTH::2024,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2021::YUSUICTRY,NSDUH,NSDUH_YOUTH::2021,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2022::YUSUICTRY,NSDUH,NSDUH_YOUTH::2022,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2023::YUSUICTRY,NSDUH,NSDUH_YOUTH::2023,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."
+NSDUH::2024::YUSUICTRY,NSDUH,NSDUH_YOUTH::2024,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,,,,,,,,,provisional_pending_two_human_reviewers,"Verify official wording, construct, population/eligibility, administered language, response codes, skip logic, and missing rules independently; do not treat this generated row as a human review."

research/stage1/primary_outcome_package.md

@@ -0,0 +1,13 @@
+# Gate 1 primary-outcome package
+
+Status: **provisional; pipeline development only**.
+
+Generated from the direct-source registry and audits by `build_primary_outcome_package.py`.
+
+- item instances: 84
+- response-dictionary rows: 396
+- survey/component design rows: 28
+- source conflicts or evidence gaps: 32
+- human reviewers recorded: 0
+
+The package does not satisfy Gate 1 by itself. `responses_long.parquet` has passed structural validation, but two actual human reviewers must independently sign every primary-outcome item; NSDUH youth attempt is absent from local public-use microdata; and several design and administered-language fields remain provisional.

research/stage1/primary_outcome_registry.md

@@ -1,6 +1,6 @@
 # Primary outcome source registry
 
-Version: 1.0 | Status: provisional | Generated: 2026-09-20
+Version: 1.4 | Status: provisional | Generated: 2026-09-20
 
 ## Scope and decision boundary
 
@@ -10,24 +10,25 @@ This registry captures source-linked candidates for suicide ideation, plan, and
 
 | Survey | Ideation | Plan | Attempt | Current evidence boundary |
 |---|---:|---:|---:|---|
-| GSHS | 2 | 2 | 2 | Workbook labels/options only; component questionnaires still require direct review. |
+| GSHS | 1 | 1 | 1 | Three administered items occur in 7/191 components; six local source packages plus WHO catalog metadata cover all seven. |
-| YRBS | 17 | 17 | 17 | 51 annual candidates; 2021/2023 data remain quarantined; annual PDFs require direct review. |
+| YRBS | 17 | 17 | 17 | 51 annual candidates directly cross-checked; 21 prior mappings corrected; 2021/2023 data remain quarantined. |
-| NSDUH | 4 | 4 | 0 | Official API metadata supports youth ideation/plan only; no youth attempt field appears in the local full dictionary. |
+| NSDUH | 4 | 4 | 4 | Attempt is administered as YSUI03/YUSUICTRY, but the raw and recoded attempt fields are absent from the local public-use package. |
 
 Counts are source-record counts, not distinct item families. YRBS counts include annual versions; NSDUH counts include 2021–2024 raw youth records only.
 
 ## Material conflicts and exclusions
 
-- GSHS exposes both `_b_` and unprefixed variants. They differ in naming and, for attempt, response form (binary versus frequency). They remain separate until questionnaire/component provenance is verified.
+- GSHS ordinary codebooks identify the three unprefixed variables as administered items. Binary Codebooks plus exact row-level relations identify the three `_b_` columns as derived or duplicate representations, not independent items.
 - GSHS self-harm variables are not included as suicide-attempt items.
-- YRBS metadata contains stale absolute paths from another machine and some automatically extracted neighboring-text contamination. Only exact primary-construct rows were retained, and their direct PDF review is still pending.
+- Direct annual questionnaire/user-guide review found 21 wrong data-column mappings in 1995, 2001, 2003, 2005, 2007, 2009, and 2011. This registry now uses the corrected user-guide variables and retains printed questionnaire numbers separately.
 - YRBS 2021 and 2023 item metadata are retained for future migration checks, but their respondent data are quarantined pending layout/import validation.
 - NSDUH adult, COVID-conditioned, imputed, recoded, and composite variables are not treated as primary raw youth items.
-- NSDUH youth attempt questions `YSUI03`–`YSUI05` are mentioned in notes, but no corresponding youth attempt variable appears in the local complete dictionary. Attempt coverage is therefore recorded as a source gap, not inferred from ideation wording.
+- Official restricted-use codebooks and the 2024 questionnaire verify `YSUI03`/`YUSUICTRY` as the youth attempt item. It is administered independently of the ideation response, but is absent from the local public-use data and cannot be analyzed from the current package.
+- `YSUI04`/`YUSUICMED` and `YSUI05`/`YUSUIHOSP` are conditional severity/follow-up items, not substitutes for the primary attempt item.
 
 ## Gate 1 status
 
-Gate 1 remains **in progress**. Before any candidate can enter confirmatory analysis, the project still needs direct official questionnaire/codebook review, exact population and skip-logic verification, canonical response/missing rules, component-specific GSHS provenance, and two actual human reviewers for primary outcomes.
+Gate 1 remains **in progress**. Before any candidate can enter confirmatory analysis, the project still needs exact remaining population/language and skip-logic verification, canonical response/missing rules, validated YRBS 2021/2023 imports, and two actual human reviewers for primary outcomes.
 
 ## Reproduction
 

research/stage1/primary_outcome_review_adjudication.csv

@@ -0,0 +1,85 @@
+item_version_id,reviewer_1_decision,reviewer_2_decision,conflict_reason,adjudicator_name,adjudication_date,final_decision,final_question_text,final_construct,final_population,final_language,final_response_or_missing_rule,adjudication_notes,adjudicator_attestation
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,,,,,,,,,,,,,
+YRBS::1991::Q19,,,,,,,,,,,,,
+YRBS::1991::Q20,,,,,,,,,,,,,
+YRBS::1991::Q21,,,,,,,,,,,,,
+YRBS::1993::Q24,,,,,,,,,,,,,
+YRBS::1993::Q25,,,,,,,,,,,,,
+YRBS::1993::Q26,,,,,,,,,,,,,
+YRBS::1995::Q22,,,,,,,,,,,,,
+YRBS::1995::Q23,,,,,,,,,,,,,
+YRBS::1995::Q24,,,,,,,,,,,,,
+YRBS::1997::Q22,,,,,,,,,,,,,
+YRBS::1997::Q23,,,,,,,,,,,,,
+YRBS::1997::Q24,,,,,,,,,,,,,
+YRBS::1999::Q23,,,,,,,,,,,,,
+YRBS::1999::Q24,,,,,,,,,,,,,
+YRBS::1999::Q25,,,,,,,,,,,,,
+YRBS::2001::Q24,,,,,,,,,,,,,
+YRBS::2001::Q25,,,,,,,,,,,,,
+YRBS::2001::Q26,,,,,,,,,,,,,
+YRBS::2003::Q24,,,,,,,,,,,,,
+YRBS::2003::Q25,,,,,,,,,,,,,
+YRBS::2003::Q26,,,,,,,,,,,,,
+YRBS::2005::Q24,,,,,,,,,,,,,
+YRBS::2005::Q25,,,,,,,,,,,,,
+YRBS::2005::Q26,,,,,,,,,,,,,
+YRBS::2007::Q24,,,,,,,,,,,,,
+YRBS::2007::Q25,,,,,,,,,,,,,
+YRBS::2007::Q26,,,,,,,,,,,,,
+YRBS::2009::Q24,,,,,,,,,,,,,
+YRBS::2009::Q25,,,,,,,,,,,,,
+YRBS::2009::Q26,,,,,,,,,,,,,
+YRBS::2011::Q25,,,,,,,,,,,,,
+YRBS::2011::Q26,,,,,,,,,,,,,
+YRBS::2011::Q27,,,,,,,,,,,,,
+YRBS::2013::Q27,,,,,,,,,,,,,
+YRBS::2013::Q28,,,,,,,,,,,,,
+YRBS::2013::Q29,,,,,,,,,,,,,
+YRBS::2015::Q27,,,,,,,,,,,,,
+YRBS::2015::Q28,,,,,,,,,,,,,
+YRBS::2015::Q29,,,,,,,,,,,,,
+YRBS::2017::Q26,,,,,,,,,,,,,
+YRBS::2017::Q27,,,,,,,,,,,,,
+YRBS::2017::Q28,,,,,,,,,,,,,
+YRBS::2019::Q26,,,,,,,,,,,,,
+YRBS::2019::Q27,,,,,,,,,,,,,
+YRBS::2019::Q28,,,,,,,,,,,,,
+YRBS::2021::Q26,,,,,,,,,,,,,
+YRBS::2021::Q27,,,,,,,,,,,,,
+YRBS::2021::Q28,,,,,,,,,,,,,
+YRBS::2023::Q27,,,,,,,,,,,,,
+YRBS::2023::Q28,,,,,,,,,,,,,
+YRBS::2023::Q29,,,,,,,,,,,,,
+NSDUH::2021::YUSUITHK,,,,,,,,,,,,,
+NSDUH::2021::YUSUIPLN,,,,,,,,,,,,,
+NSDUH::2022::YUSUITHK,,,,,,,,,,,,,
+NSDUH::2022::YUSUIPLN,,,,,,,,,,,,,
+NSDUH::2023::YUSUITHK,,,,,,,,,,,,,
+NSDUH::2023::YUSUIPLN,,,,,,,,,,,,,
+NSDUH::2024::YUSUITHK,,,,,,,,,,,,,
+NSDUH::2024::YUSUIPLN,,,,,,,,,,,,,
+NSDUH::2021::YUSUICTRY,,,,,,,,,,,,,
+NSDUH::2022::YUSUICTRY,,,,,,,,,,,,,
+NSDUH::2023::YUSUICTRY,,,,,,,,,,,,,
+NSDUH::2024::YUSUICTRY,,,,,,,,,,,,,

research/stage1/primary_outcome_review_reviewer_1.csv

@@ -0,0 +1,85 @@
+item_version_id,survey,component_id,construct,question_text,response_dictionary_rows,population,language,source_file,source_url,page_or_section,reviewer_name,reviewer_affiliation,review_date,decision,wording_verified,construct_verified,population_verified,response_codes_verified,skip_logic_verified,missing_rules_verified,language_evidence_status,corrected_question_text,corrected_construct,corrected_population,corrected_language,corrected_response_or_missing_rule,review_notes,independence_attestation
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,,,,,,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,,,,,,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q19,YRBS,YRBS_NATIONAL::1991,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q20,YRBS,YRBS_NATIONAL::1991,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q21,YRBS,YRBS_NATIONAL::1991,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q24,YRBS,YRBS_NATIONAL::1993,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q25,YRBS,YRBS_NATIONAL::1993,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q26,YRBS,YRBS_NATIONAL::1993,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q22,YRBS,YRBS_NATIONAL::1995,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q23,YRBS,YRBS_NATIONAL::1995,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q24,YRBS,YRBS_NATIONAL::1995,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q22,YRBS,YRBS_NATIONAL::1997,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q23,YRBS,YRBS_NATIONAL::1997,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q24,YRBS,YRBS_NATIONAL::1997,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q23,YRBS,YRBS_NATIONAL::1999,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q24,YRBS,YRBS_NATIONAL::1999,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q25,YRBS,YRBS_NATIONAL::1999,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q24,YRBS,YRBS_NATIONAL::2001,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q25,YRBS,YRBS_NATIONAL::2001,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q26,YRBS,YRBS_NATIONAL::2001,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q24,YRBS,YRBS_NATIONAL::2003,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q25,YRBS,YRBS_NATIONAL::2003,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q26,YRBS,YRBS_NATIONAL::2003,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q24,YRBS,YRBS_NATIONAL::2005,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q25,YRBS,YRBS_NATIONAL::2005,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q26,YRBS,YRBS_NATIONAL::2005,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q24,YRBS,YRBS_NATIONAL::2007,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q25,YRBS,YRBS_NATIONAL::2007,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q26,YRBS,YRBS_NATIONAL::2007,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q24,YRBS,YRBS_NATIONAL::2009,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q25,YRBS,YRBS_NATIONAL::2009,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q26,YRBS,YRBS_NATIONAL::2009,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q25,YRBS,YRBS_NATIONAL::2011,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q26,YRBS,YRBS_NATIONAL::2011,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q27,YRBS,YRBS_NATIONAL::2011,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q27,YRBS,YRBS_NATIONAL::2013,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q28,YRBS,YRBS_NATIONAL::2013,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q29,YRBS,YRBS_NATIONAL::2013,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q27,YRBS,YRBS_NATIONAL::2015,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q28,YRBS,YRBS_NATIONAL::2015,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q29,YRBS,YRBS_NATIONAL::2015,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q26,YRBS,YRBS_NATIONAL::2017,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q27,YRBS,YRBS_NATIONAL::2017,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q28,YRBS,YRBS_NATIONAL::2017,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q26,YRBS,YRBS_NATIONAL::2019,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q27,YRBS,YRBS_NATIONAL::2019,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q28,YRBS,YRBS_NATIONAL::2019,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q26,YRBS,YRBS_NATIONAL::2021,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q27,YRBS,YRBS_NATIONAL::2021,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q28,YRBS,YRBS_NATIONAL::2021,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q27,YRBS,YRBS_NATIONAL::2023,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q28,YRBS,YRBS_NATIONAL::2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q29,YRBS,YRBS_NATIONAL::2023,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUITHK,NSDUH,NSDUH_YOUTH::2021,suicide_ideation,"The next few questions are about thoughts of suicide. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself ?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUIPLN,NSDUH,NSDUH_YOUTH::2021,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUITHK,NSDUH,NSDUH_YOUTH::2022,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUIPLN,NSDUH,NSDUH_YOUTH::2022,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUITHK,NSDUH,NSDUH_YOUTH::2023,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUIPLN,NSDUH,NSDUH_YOUTH::2023,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUITHK,NSDUH,NSDUH_YOUTH::2024,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YSUI02, YSUI03, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUIPLN,NSDUH,NSDUH_YOUTH::2024,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUICTRY,NSDUH,NSDUH_YOUTH::2021,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUICTRY,NSDUH,NSDUH_YOUTH::2022,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUICTRY,NSDUH,NSDUH_YOUTH::2023,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUICTRY,NSDUH,NSDUH_YOUTH::2024,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,,,,,,,,,,,,,,,,,,

research/stage1/primary_outcome_review_reviewer_2.csv

@@ -0,0 +1,85 @@
+item_version_id,survey,component_id,construct,question_text,response_dictionary_rows,population,language,source_file,source_url,page_or_section,reviewer_name,reviewer_affiliation,review_date,decision,wording_verified,construct_verified,population_verified,response_codes_verified,skip_logic_verified,missing_rules_verified,language_evidence_status,corrected_question_text,corrected_construct,corrected_population,corrected_language,corrected_response_or_missing_rule,review_notes,independence_attestation
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,,,,,,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,,,,,,,,,,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,GSHS,2023_MAR_GSHS_v01::mar_fez2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,GSHS,GHA_2022_GSHS_v01::gha_sek_tak2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,,,,,,,,,,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,GSHS,IND_2022_GSHS_v01::ind_jaipur_2022,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,,,,,,,,,,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,GSHS,JAM_2023_GSHS_v01::jam_st_cath_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,,,,,,,,,,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,GSHS,MNG_2023_GSHS_v01::mng2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,English; Mongolian; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,GSHS,SLB_2023_GSHS_v01::slb_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,English catalog literal-question metadata; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_ideation,"During the past 12 months, did you seriously consider attempting suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,,,,,,,,,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,GSHS,WLF_2023_GSHS_v01::wlf_2023,suicide_attempt,"During the past 12 months, how many times did you attempt suicide?",6,school-attending students; exact sampled ages/grades remain pending component source review,French; English reference; actual administered language not established,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q19,YRBS,YRBS_NATIONAL::1991,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q20,YRBS,YRBS_NATIONAL::1991,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1991::Q21,YRBS,YRBS_NATIONAL::1991,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q24,YRBS,YRBS_NATIONAL::1993,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q25,YRBS,YRBS_NATIONAL::1993,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1993::Q26,YRBS,YRBS_NATIONAL::1993,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q22,YRBS,YRBS_NATIONAL::1995,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q23,YRBS,YRBS_NATIONAL::1995,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1995::Q24,YRBS,YRBS_NATIONAL::1995,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q22,YRBS,YRBS_NATIONAL::1997,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q23,YRBS,YRBS_NATIONAL::1997,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1997::Q24,YRBS,YRBS_NATIONAL::1997,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q23,YRBS,YRBS_NATIONAL::1999,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q24,YRBS,YRBS_NATIONAL::1999,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::1999::Q25,YRBS,YRBS_NATIONAL::1999,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q24,YRBS,YRBS_NATIONAL::2001,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q25,YRBS,YRBS_NATIONAL::2001,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2001::Q26,YRBS,YRBS_NATIONAL::2001,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q24,YRBS,YRBS_NATIONAL::2003,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q25,YRBS,YRBS_NATIONAL::2003,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2003::Q26,YRBS,YRBS_NATIONAL::2003,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q24,YRBS,YRBS_NATIONAL::2005,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q25,YRBS,YRBS_NATIONAL::2005,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2005::Q26,YRBS,YRBS_NATIONAL::2005,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q24,YRBS,YRBS_NATIONAL::2007,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q25,YRBS,YRBS_NATIONAL::2007,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2007::Q26,YRBS,YRBS_NATIONAL::2007,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q24,YRBS,YRBS_NATIONAL::2009,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q25,YRBS,YRBS_NATIONAL::2009,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2009::Q26,YRBS,YRBS_NATIONAL::2009,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q25,YRBS,YRBS_NATIONAL::2011,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q26,YRBS,YRBS_NATIONAL::2011,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2011::Q27,YRBS,YRBS_NATIONAL::2011,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q27,YRBS,YRBS_NATIONAL::2013,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q28,YRBS,YRBS_NATIONAL::2013,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2013::Q29,YRBS,YRBS_NATIONAL::2013,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q27,YRBS,YRBS_NATIONAL::2015,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q28,YRBS,YRBS_NATIONAL::2015,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2015::Q29,YRBS,YRBS_NATIONAL::2015,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q26,YRBS,YRBS_NATIONAL::2017,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q27,YRBS,YRBS_NATIONAL::2017,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2017::Q28,YRBS,YRBS_NATIONAL::2017,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q26,YRBS,YRBS_NATIONAL::2019,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q27,YRBS,YRBS_NATIONAL::2019,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2019::Q28,YRBS,YRBS_NATIONAL::2019,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q26,YRBS,YRBS_NATIONAL::2021,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q27,YRBS,YRBS_NATIONAL::2021,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2021::Q28,YRBS,YRBS_NATIONAL::2021,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q27,YRBS,YRBS_NATIONAL::2023,suicide_ideation,"During the past 12 months, did you ever seriously consider attempting suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q28,YRBS,YRBS_NATIONAL::2023,suicide_plan,"During the past 12 months, did you make a plan about how you would attempt suicide?",3,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+YRBS::2023::Q29,YRBS,YRBS_NATIONAL::2023,suicide_attempt,"During the past 12 months, how many times did you actually attempt suicide?",6,students in grades 9-12 attending public and private schools in the United States; detailed eligibility remains subject to annual design review,English questionnaire source; actual accommodation/language coverage not established by this audit,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUITHK,NSDUH,NSDUH_YOUTH::2021,suicide_ideation,"The next few questions are about thoughts of suicide. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself ?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUIPLN,NSDUH,NSDUH_YOUTH::2021,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUITHK,NSDUH,NSDUH_YOUTH::2022,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUIPLN,NSDUH,NSDUH_YOUTH::2022,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUITHK,NSDUH,NSDUH_YOUTH::2023,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YCOV9, YSUI02, YCOV10, YSUI03, YCOV11, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUIPLN,NSDUH,NSDUH_YOUTH::2023,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUITHK,NSDUH,NSDUH_YOUTH::2024,suicide_ideation,"Note: Beginning in 2022, questions YSUI01, YSUI02, YSUI03, YSUI04, and YSUI05 were moved from the youth mental health service utilization section to the youth experiences section. The next few questions are about thoughts of suicide. You can answer “I’m not sure” or “I don’t want to answer” to any question. At any time in the past 12 months, that is from [DATEFILL] up to and including today, did you seriously think about trying to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUIPLN,NSDUH,NSDUH_YOUTH::2024,suicide_plan,"During the past 12 months, did you make any plans to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,,,,,,,,,,,,,,,,,,
+NSDUH::2021::YUSUICTRY,NSDUH,NSDUH_YOUTH::2021,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2022::YUSUICTRY,NSDUH,NSDUH_YOUTH::2022,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2023::YUSUICTRY,NSDUH,NSDUH_YOUTH::2023,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,,,,,,,,,,,,,,,,,,
+NSDUH::2024::YUSUICTRY,NSDUH,NSDUH_YOUTH::2024,suicide_attempt,"During the past 12 months, did you try to kill yourself?",9,adolescents aged 12-17; final eligibility and skip logic require annual guide sign-off,English source metadata; administered-language/accommodation coverage not established,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,,,,,,,,,,,,,,,,,,

research/stage1/repair_yrbs_2017_2019_design.py

@@ -0,0 +1,134 @@
+"""Restore YRBS 2017/2019 design fields from official fixed-width locations."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+
+import pyarrow as pa
+import pyarrow.csv as pacsv
+import pyarrow.parquet as pq
+
+
+ROOT = Path(__file__).resolve().parents[2]
+RAW = ROOT / "Dataset" / "YRBS_National_1991_2023" / "raw"
+GUIDES = ROOT / "Dataset" / "YRBS_National_1991_2023" / "documentation" / "UserGuide"
+FULL = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "YRBS" / "full_by_year"
+STAGE1 = ROOT / "research" / "stage1"
+SELECTED_PARQUET = FULL.parent / "yrbs_1991_2019_selected.parquet"
+SELECTED_CSV = FULL.parent / "yrbs_1991_2019_selected.csv"
+SPECS = {
+    2017: {
+        "raw": RAW / "XXH2017_YRBS_Data.dat",
+        "guide": GUIDES / "2017_YRBS_Data_Users_Guide.pdf",
+        "page": "PDF page 102 / printed page 96",
+        "positions": {"weight": (387, 396), "stratum": (397, 399), "psu": (400, 405)},
+    },
+    2019: {
+        "raw": RAW / "XXH2019_YRBS_Data.dat",
+        "guide": GUIDES / "2019_National_YRBS_Data_Users_Guide.pdf",
+        "page": "PDF page 89 / printed page 86",
+        "positions": {"weight": (386, 395), "stratum": (396, 398), "psu": (399, 404)},
+    },
+}
+
+
+def digest(path: Path) -> str:
+    h = hashlib.sha256()
+    with path.open("rb") as handle:
+        for block in iter(lambda: handle.read(1024 * 1024), b""):
+            h.update(block)
+    return h.hexdigest()
+
+
+def parse_numeric(line: str, start: int, end: int) -> float | None:
+    text = line[start - 1 : end].strip()
+    return None if not text or text == "." else float(text)
+
+
+def main() -> None:
+    results = []
+    repaired_values = {}
+    for year, spec in SPECS.items():
+        parquet = FULL / f"yrbs_{year}_full.parquet"
+        table = pq.read_table(parquet)
+        source_rows = table.column("source_row").to_pylist()
+        if source_rows != list(range(1, table.num_rows + 1)):
+            raise AssertionError(f"{year}: source_row is not sequential; cannot prove raw-row alignment")
+        values = {name: [] for name in spec["positions"]}
+        lengths = set()
+        with spec["raw"].open(encoding="ascii", newline="") as handle:
+            for line in handle:
+                line = line.rstrip("\r\n")
+                lengths.add(len(line))
+                for name, (start, end) in spec["positions"].items():
+                    values[name].append(parse_numeric(line, start, end))
+        if any(len(column) != table.num_rows for column in values.values()):
+            raise AssertionError(f"{year}: raw/Parquet row counts differ")
+        for name, column in values.items():
+            index = table.schema.get_field_index(name)
+            table = table.set_column(index, name, pa.array(column, type=pa.float64()))
+        temp = parquet.with_suffix(".repair.tmp.parquet")
+        pq.write_table(table, temp, compression="zstd")
+        check = pq.read_table(temp, columns=["source_row", "weight", "stratum", "psu"])
+        nonmissing = {name: check.column(name).null_count for name in ("weight", "stratum", "psu")}
+        if any(nonmissing.values()):
+            raise AssertionError(f"{year}: design fields still contain nulls: {nonmissing}")
+        if min(check.column("weight").to_pylist()) <= 0:
+            raise AssertionError(f"{year}: nonpositive weight")
+        temp.replace(parquet)
+        repaired_values[year] = values
+        weight_sum = sum(values["weight"])
+        results.append({
+            "year": year, "rows": table.num_rows, "raw_record_lengths": sorted(lengths),
+            "raw_file": str(spec["raw"].relative_to(ROOT)).replace("\\", "/"),
+            "raw_sha256": digest(spec["raw"]),
+            "guide_file": str(spec["guide"].relative_to(ROOT)).replace("\\", "/"),
+            "guide_sha256": digest(spec["guide"]), "page_or_section": spec["page"],
+            "positions": spec["positions"], "design_nulls_after_repair": nonmissing,
+            "weight_min": min(values["weight"]), "weight_max": max(values["weight"]),
+            "weight_sum": weight_sum,
+            "weight_sum_minus_sample_size": weight_sum - table.num_rows,
+            "output_file": str(parquet.relative_to(ROOT)).replace("\\", "/"),
+            "status": "passed",
+        })
+    selected = pq.read_table(SELECTED_PARQUET)
+    years = selected.column("survey_year").to_pylist()
+    source_rows = selected.column("source_row").to_pylist()
+    for name in ("weight", "stratum", "psu"):
+        existing = selected.column(name).to_pylist()
+        repaired = [
+            repaired_values[int(year)][name][int(source_row) - 1]
+            if int(year) in repaired_values else old
+            for old, year, source_row in zip(existing, years, source_rows)
+        ]
+        selected = selected.set_column(selected.schema.get_field_index(name), name, pa.array(repaired, type=pa.float64()))
+    selected_temp = SELECTED_PARQUET.with_suffix(".repair.tmp.parquet")
+    pq.write_table(selected, selected_temp, compression="zstd")
+    selected_temp.replace(SELECTED_PARQUET)
+    pacsv.write_csv(selected, SELECTED_CSV)
+    for result in results:
+        year = result["year"]
+        mask = [i for i, value in enumerate(years) if int(value) == year]
+        result["selected_table_design_nulls_after_repair"] = {
+            name: sum(selected.column(name)[i].as_py() is None for i in mask)
+            for name in ("weight", "stratum", "psu")
+        }
+    audit = {
+        "schema_version": "1.0", "generated_on": "2026-09-20", "status": "passed",
+        "purpose": "Restore YRBS 2017/2019 weight, stratum, and PSU from the official guide's fixed-width locations.",
+        "years": results,
+        "decision": "2017 and 2019 design fields are no longer missing in the annual full Parquet files; use WEIGHT with STRATUM and PSU in complex-survey procedures.",
+    }
+    (STAGE1 / "yrbs_2017_2019_design_repair_audit.json").write_text(json.dumps(audit, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    lines = ["# YRBS 2017/2019 design-field repair audit", "", audit["decision"], ""]
+    for row in results:
+        lines += [f"## {row['year']}", "", f"- rows: {row['rows']:,}", f"- official locations: `{row['positions']}` ({row['page_or_section']})", f"- design nulls after repair: `{row['design_nulls_after_repair']}`", f"- weight range/sum: {row['weight_min']:.4f}–{row['weight_max']:.4f}; sum {row['weight_sum']:.4f}", ""]
+    lines += ["The repair changes only derived Parquet files, which remain reproducible and excluded from Git. Official raw files are never modified.", ""]
+    (STAGE1 / "yrbs_2017_2019_design_repair_audit.md").write_text("\n".join(lines), encoding="utf-8")
+    print(json.dumps(audit, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/response_dictionary.csv

@@ -0,0 +1,397 @@
+item_version_id,raw_code,raw_label,canonical_code,missing_type,is_observed_response,derivation_rule,source_file,source_url,page_or_section,review_status
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q32,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q33,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Q34,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q33,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q34,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Q35,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q34,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q35,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Q36,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q28,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q29,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Q30,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q36,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q37,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Q38,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,Master_Columns plus component-specific questionnaire/codebook references in component audit,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q29,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q30,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Q31,provisional
+YRBS::1991::Q19,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q19,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q19,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q20,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q20,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q20,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1991::Q21,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1991_hs_questionnaire.pdf,,page 5; data guide page 9,provisional
+YRBS::1993::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1993::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1993_xxh_questionnaire.pdf,,page 6; data guide page 11,provisional
+YRBS::1995::Q22,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q22,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q22,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q23,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q23,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q23,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1995::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q22,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q22,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q22,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q23,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q23,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q23,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1997::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1997_xxh_questionnaire.pdf,,page 6; data guide pages 11-12,provisional
+YRBS::1999::Q23,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q23,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q23,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::1999::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1999_xxh_questionnaire.pdf,,page 7; data guide page 7,provisional
+YRBS::2001::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2001::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,,page 7; data guide pages 8-9,provisional
+YRBS::2003::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2003::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,,page 7; data guide pages 9-10,provisional
+YRBS::2005::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2005::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,,page 7; data guide pages 16-17,provisional
+YRBS::2007::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2007::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,,page 7; data guide page 20,provisional
+YRBS::2009::Q24,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q24,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q24,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2009::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,,page 7; data guide page 22,provisional
+YRBS::2011::Q25,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q25,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q25,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q26,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q26,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2011::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,,pages 7-8; data guide page 20,provisional
+YRBS::2013::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q28,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q28,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2013::Q29,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2013_xxh_questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2015::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q28,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q28,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2015::Q29,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2015_xxh_questionnaire.pdf,,pages 7-8; data guide page 29,provisional
+YRBS::2017::Q26,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q26,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2017::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2017_yrbs_national_hs_questionnaire.pdf,,page 8; data guide page 29,provisional
+YRBS::2019::Q26,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q26,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2019::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2019_YRBS-National-HS-Questionnaire.pdf,,page 8; data guide pages 27-28,provisional
+YRBS::2021::Q26,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q26,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q26,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2021::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2021-YRBS-National-HS-Questionnaire.pdf,,page 8; data guide page 28,provisional
+YRBS::2023::Q27,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q27,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q27,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q28,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q28,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q28,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,1,0 times,zero,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,2,1 time,one,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,3,2 or 3 times,two_or_three,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,4,4 or 5 times,four_or_five,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,5,6 or more times,six_or_more,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+YRBS::2023::Q29,<missing>,blank/null/sysmiss; source does not distinguish reason,,unknown,false,retain as unknown missing; never recode as No/zero without an explicit official rule,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2023_YRBS_National_HS_Questionnaire.pdf,,page 9; data guide page 29,provisional
+NSDUH::2021::YUSUITHK,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUITHK,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2021::YUSUIPLN,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUIPLN,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2021-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUITHK,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUITHK,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2022::YUSUIPLN,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2022::YUSUIPLN,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2022-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUITHK,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUITHK,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2023::YUSUIPLN,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2023::YUSUIPLN,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2023-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUITHK,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUITHK,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUITHK,provisional
+NSDUH::2024::YUSUIPLN,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2024::YUSUIPLN,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/可直接分析数据包_NSDUH_YRBS/NSDUH/nsduh_complete_variable_dictionary.csv,https://datatools.samhsa.gov/api/surveys/NSDUH-2024-DS0001/?format=json,YUSUIPLN,provisional
+NSDUH::2021::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2021::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2022::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2023::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,2,No,no,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,3,I'm not sure,uncertain,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,4,I don't want to answer,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,85,BAD DATA Logically assigned,,data_error,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,94,DON'T KNOW,,dont_know,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,97,REFUSED,,refused,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional
+NSDUH::2024::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,direct recode; no imputation and no silent conversion of nonresponse to a negative response,,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,provisional

research/stage1/responses_long_audit.md

@@ -0,0 +1,12 @@
+# Primary-outcome response long-table audit
+
+Status: **provisional; structural validation passed**.
+
+- rows: 919,863
+- unique respondent × item keys: 919,863
+- item instances with local response data: 80 of 84
+- rows by survey: `{'GSHS': 64599, 'NSDUH': 91236, 'YRBS': 764028}`
+- observed/missing statuses: `{'data_error': 177, 'dont_know': 458, 'observed': 867995, 'ordinary_missing': 172, 'refused': 6544, 'unknown': 44517}`
+- SHA-256: `0260386444fd2d4a9b0183ef79b171b4fa47ab1d7c1706b05619c14cc8f8a197`
+
+The output row totals equal counts independently derived from the seven GSHS components, all 17 YRBS annual full tables, and NSDUH respondents with CATAG2=1. Required identifiers/status fields are complete, respondent × item keys are unique, and every observed response has a canonical response. The four NSDUH attempt instances remain in the item bank without response rows because the public-use microdata omit those fields. Human double review is still required.

research/stage1/responses_long_manifest.json

@@ -0,0 +1,132 @@
+{
+  "schema_version": "1.0",
+  "generated_on": "2026-09-20",
+  "status": "provisional",
+  "output_file": "Dataset/可直接分析数据包_NSDUH_YRBS/harmonization/responses_long.parquet",
+  "sha256": "0260386444fd2d4a9b0183ef79b171b4fa47ab1d7c1706b05619c14cc8f8a197",
+  "bytes": 4405969,
+  "rows": 919863,
+  "unique_response_keys": 919863,
+  "item_instances_with_rows": 80,
+  "rows_by_survey": {
+    "GSHS": 64599,
+    "NSDUH": 91236,
+    "YRBS": 764028
+  },
+  "source_derived_expected_rows": {
+    "GSHS": 64599,
+    "NSDUH": 91236,
+    "YRBS": 764028
+  },
+  "rows_by_item": {
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui": 4172,
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui": 4172,
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui": 4172,
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui": 3796,
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui": 3796,
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui": 3796,
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui": 4299,
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui": 4299,
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui": 4299,
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui": 3041,
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui": 3041,
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui": 3041,
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui": 3311,
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui": 3311,
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui": 3311,
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui": 1995,
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui": 1995,
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui": 1995,
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui": 919,
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui": 919,
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui": 919,
+    "NSDUH::2021::YUSUIPLN": 10743,
+    "NSDUH::2021::YUSUITHK": 10743,
+    "NSDUH::2022::YUSUIPLN": 11969,
+    "NSDUH::2022::YUSUITHK": 11969,
+    "NSDUH::2023::YUSUIPLN": 11572,
+    "NSDUH::2023::YUSUITHK": 11572,
+    "NSDUH::2024::YUSUIPLN": 11334,
+    "NSDUH::2024::YUSUITHK": 11334,
+    "YRBS::1991::Q19": 12272,
+    "YRBS::1991::Q20": 12272,
+    "YRBS::1991::Q21": 12272,
+    "YRBS::1993::Q24": 16296,
+    "YRBS::1993::Q25": 16296,
+    "YRBS::1993::Q26": 16296,
+    "YRBS::1995::Q22": 10904,
+    "YRBS::1995::Q23": 10904,
+    "YRBS::1995::Q24": 10904,
+    "YRBS::1997::Q22": 16263,
+    "YRBS::1997::Q23": 16263,
+    "YRBS::1997::Q24": 16263,
+    "YRBS::1999::Q23": 15349,
+    "YRBS::1999::Q24": 15349,
+    "YRBS::1999::Q25": 15349,
+    "YRBS::2001::Q24": 13601,
+    "YRBS::2001::Q25": 13601,
+    "YRBS::2001::Q26": 13601,
+    "YRBS::2003::Q24": 15214,
+    "YRBS::2003::Q25": 15214,
+    "YRBS::2003::Q26": 15214,
+    "YRBS::2005::Q24": 13917,
+    "YRBS::2005::Q25": 13917,
+    "YRBS::2005::Q26": 13917,
+    "YRBS::2007::Q24": 14041,
+    "YRBS::2007::Q25": 14041,
+    "YRBS::2007::Q26": 14041,
+    "YRBS::2009::Q24": 16410,
+    "YRBS::2009::Q25": 16410,
+    "YRBS::2009::Q26": 16410,
+    "YRBS::2011::Q25": 15425,
+    "YRBS::2011::Q26": 15425,
+    "YRBS::2011::Q27": 15425,
+    "YRBS::2013::Q27": 13583,
+    "YRBS::2013::Q28": 13583,
+    "YRBS::2013::Q29": 13583,
+    "YRBS::2015::Q27": 15624,
+    "YRBS::2015::Q28": 15624,
+    "YRBS::2015::Q29": 15624,
+    "YRBS::2017::Q26": 14765,
+    "YRBS::2017::Q27": 14765,
+    "YRBS::2017::Q28": 14765,
+    "YRBS::2019::Q26": 13677,
+    "YRBS::2019::Q27": 13677,
+    "YRBS::2019::Q28": 13677,
+    "YRBS::2021::Q26": 17232,
+    "YRBS::2021::Q27": 17232,
+    "YRBS::2021::Q28": 17232,
+    "YRBS::2023::Q27": 20103,
+    "YRBS::2023::Q28": 20103,
+    "YRBS::2023::Q29": 20103
+  },
+  "observed_status_counts": {
+    "data_error": 177,
+    "dont_know": 458,
+    "observed": 867995,
+    "ordinary_missing": 172,
+    "refused": 6544,
+    "unknown": 44517
+  },
+  "missing_type_counts": {
+    "data_error": 177,
+    "dont_know": 458,
+    "ordinary_missing": 172,
+    "refused": 6544,
+    "unknown": 44517
+  },
+  "required_field_nulls": 0,
+  "observed_rows_without_canonical_response": 0,
+  "eligibility_rules": {
+    "GSHS": "Rows only from the seven components where the primary items were administered.",
+    "YRBS": "All respondents in each verified national annual full table; blank source responses remain unknown missing.",
+    "NSDUH": "CATAG2=1 (official label: 12-17 years old); only YUSUITHK and YUSUIPLN are locally available."
+  },
+  "excluded_item_instances": [
+    "NSDUH::2021::YUSUICTRY",
+    "NSDUH::2022::YUSUICTRY",
+    "NSDUH::2023::YUSUICTRY",
+    "NSDUH::2024::YUSUICTRY"
+  ],
+  "gate_boundary": "No human reviewer fields are inferred. Four NSDUH attempt items have no response rows because the fields are absent from local public-use microdata."
+}

research/stage1/source_conflicts.csv

@@ -0,0 +1,33 @@
+conflict_id,survey,year,component_id,source_variable,conflict_type,source_a,source_b,description,resolution,analysis_consequence,status,reviewer_1,reviewer_2
+GSHS_LANGUAGE::2023_MAR_GSHS_v01::mar_fez2023,GSHS,2023,2023_MAR_GSHS_v01::mar_fez2023,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_FRENCH.pdf,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::GHA_2022_GSHS_v01::gha_sek_tak2022,GSHS,2022,GHA_2022_GSHS_v01::gha_sek_tak2022,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::IND_2022_GSHS_v01::ind_jaipur_2022,GSHS,2022,IND_2022_GSHS_v01::ind_jaipur_2022,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,2023,JAM_2023_GSHS_v01::jam_st_cath_2023,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::MNG_2023_GSHS_v01::mng2023,GSHS,2023,MNG_2023_GSHS_v01::mng2023,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::SLB_2023_GSHS_v01::slb_2023,GSHS,2023,SLB_2023_GSHS_v01::slb_2023,all_primary_outcomes,evidence_gap_administered_language,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+GSHS_LANGUAGE::WLF_2023_GSHS_v01::wlf_2023,GSHS,2023,WLF_2023_GSHS_v01::wlf_2023,all_primary_outcomes,evidence_gap_administered_language,Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - French.docx,,Available questionnaire language evidence does not establish the language administered to every respondent.,unresolved; retain language as provisional and exclude language-DIF claims,"May be used for pipeline development, not confirmatory language comparison.",open,,
+YRBS_MAPPING::1995::suicide_ideation,YRBS,1995,YRBS_NATIONAL::1995,Q22,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1995_National_User_Guide.pdf,Previous registry used Q30; direct annual data guide maps the printed question to Q22.,Corrected registry mapping to Q22; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::1995::suicide_plan,YRBS,1995,YRBS_NATIONAL::1995,Q23,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1995_National_User_Guide.pdf,Previous registry used Q31; direct annual data guide maps the printed question to Q23.,Corrected registry mapping to Q23; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::1995::suicide_attempt,YRBS,1995,YRBS_NATIONAL::1995,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/1995_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1995_National_User_Guide.pdf,Previous registry used Q32; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2001::suicide_ideation,YRBS,2001,YRBS_NATIONAL::2001,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2001_National_User_Guide.pdf,Previous registry used Q25; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2001::suicide_plan,YRBS,2001,YRBS_NATIONAL::2001,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2001_National_User_Guide.pdf,Previous registry used Q26; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2001::suicide_attempt,YRBS,2001,YRBS_NATIONAL::2001,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2001_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2001_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2003::suicide_ideation,YRBS,2003,YRBS_NATIONAL::2003,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2003_National_User_Guide.pdf,Previous registry used Q25; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2003::suicide_plan,YRBS,2003,YRBS_NATIONAL::2003,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2003_National_User_Guide.pdf,Previous registry used Q26; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2003::suicide_attempt,YRBS,2003,YRBS_NATIONAL::2003,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2003_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2003_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2005::suicide_ideation,YRBS,2005,YRBS_NATIONAL::2005,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2005_National_User_Guide.pdf,Previous registry used Q26; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2005::suicide_plan,YRBS,2005,YRBS_NATIONAL::2005,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2005_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2005::suicide_attempt,YRBS,2005,YRBS_NATIONAL::2005,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2005_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2005_National_User_Guide.pdf,Previous registry used Q28; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2007::suicide_ideation,YRBS,2007,YRBS_NATIONAL::2007,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2007_National_User_Guide.pdf,Previous registry used Q25; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2007::suicide_plan,YRBS,2007,YRBS_NATIONAL::2007,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2007_National_User_Guide.pdf,Previous registry used Q26; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2007::suicide_attempt,YRBS,2007,YRBS_NATIONAL::2007,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2007_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2007_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2009::suicide_ideation,YRBS,2009,YRBS_NATIONAL::2009,Q24,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2009_National_User_Guide.pdf,Previous registry used Q25; direct annual data guide maps the printed question to Q24.,Corrected registry mapping to Q24; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2009::suicide_plan,YRBS,2009,YRBS_NATIONAL::2009,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2009_National_User_Guide.pdf,Previous registry used Q26; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2009::suicide_attempt,YRBS,2009,YRBS_NATIONAL::2009,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2009_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2009_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2011::suicide_ideation,YRBS,2011,YRBS_NATIONAL::2011,Q25,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2011_National_User_Guide.pdf,Previous registry used Q27; direct annual data guide maps the printed question to Q25.,Corrected registry mapping to Q25; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2011::suicide_plan,YRBS,2011,YRBS_NATIONAL::2011,Q26,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2011_National_User_Guide.pdf,Previous registry used Q28; direct annual data guide maps the printed question to Q26.,Corrected registry mapping to Q26; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+YRBS_MAPPING::2011::suicide_attempt,YRBS,2011,YRBS_NATIONAL::2011,Q27,registry_to_data_variable_mapping,Dataset/YRBS_National_1991_2023/documentation/Questionnaire/2011_xxh_questionnaire.pdf,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2011_National_User_Guide.pdf,Previous registry used Q29; direct annual data guide maps the printed question to Q27.,Corrected registry mapping to Q27; printed questionnaire number retained separately.,Use corrected data variable; do not reuse the superseded mapping.,resolved_by_direct_source_audit,,
+NSDUH_AVAILABILITY::2021::YUSUICTRY,NSDUH,2021,NSDUH_YOUTH::2021,YUSUICTRY,official_item_missing_from_local_public_use_microdata,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,local full and selected schemas,"Official source documents the youth attempt item, but neither its raw nor recoded field is present in the local public-use files.",unresolved access constraint; retain in item bank but do not generate responses,NSDUH attempt cannot enter respondent-level analysis without authorized restricted-use data or a separately justified aggregate design.,open_access_constraint,,
+NSDUH_AVAILABILITY::2022::YUSUICTRY,NSDUH,2022,NSDUH_YOUTH::2022,YUSUICTRY,official_item_missing_from_local_public_use_microdata,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,local full and selected schemas,"Official source documents the youth attempt item, but neither its raw nor recoded field is present in the local public-use files.",unresolved access constraint; retain in item bank but do not generate responses,NSDUH attempt cannot enter respondent-level analysis without authorized restricted-use data or a separately justified aggregate design.,open_access_constraint,,
+NSDUH_AVAILABILITY::2023::YUSUICTRY,NSDUH,2023,NSDUH_YOUTH::2023,YUSUICTRY,official_item_missing_from_local_public_use_microdata,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,local full and selected schemas,"Official source documents the youth attempt item, but neither its raw nor recoded field is present in the local public-use files.",unresolved access constraint; retain in item bank but do not generate responses,NSDUH attempt cannot enter respondent-level analysis without authorized restricted-use data or a separately justified aggregate design.,open_access_constraint,,
+NSDUH_AVAILABILITY::2024::YUSUICTRY,NSDUH,2024,NSDUH_YOUTH::2024,YUSUICTRY,official_item_missing_from_local_public_use_microdata,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,local full and selected schemas,"Official source documents the youth attempt item, but neither its raw nor recoded field is present in the local public-use files.",unresolved access constraint; retain in item bank but do not generate responses,NSDUH attempt cannot enter respondent-level analysis without authorized restricted-use data or a separately justified aggregate design.,open_access_constraint,,

research/stage1/survey_design.csv

@@ -0,0 +1,29 @@
+survey_id,component_id,survey,country,year,population,weight_field,psu_field,stratum_field,variance_method,namespace_rule,design_source,design_status,review_status,notes
+GSHS::2023_MAR_GSHS_v01,2023_MAR_GSHS_v01::mar_fez2023,GSHS,Morocco,2023,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/982; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::GHA_2022_GSHS_v01,GHA_2022_GSHS_v01::gha_sek_tak2022,GSHS,Ghana,2022,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/981; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::IND_2022_GSHS_v01,IND_2022_GSHS_v01::ind_jaipur_2022,GSHS,India,2022,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/984; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::JAM_2023_GSHS_v01,JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,Jamaica,2023,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/983; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::MNG_2023_GSHS_v01,MNG_2023_GSHS_v01::mng2023,GSHS,Mongolia,2023,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/990; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::SLB_2023_GSHS_v01,SLB_2023_GSHS_v01::slb_2023,GSHS,Solomon Islands,2023,school-going adolescents aged 13-17 years; Form 1-Form 6; all students in selected classes eligible,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/992; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+GSHS::WLF_2023_GSHS_v01,WLF_2023_GSHS_v01::wlf_2023,GSHS,Wallis and Futuna,2023,school-attending students; exact sampled ages/grades remain pending component source review,sample_weight,sampling_psu,sampling_stratum,"complex-survey design using weight, stratum, and PSU; Taylor linearization planned",prefix PSU and stratum with component_id before pooling,https://extranet.who.int/ncdsmicrodata/index.php/catalog/994; WHO GSHS methodology and data catalog,source_verified_fields,provisional,"For all 21,533 respondents in the seven primary-outcome components, canonical weight/PSU/stratum fields are complete, positive, and numerically identical to raw_weight/raw_psu/raw_stratum. Namespace by component before pooling."
+YRBS::1991,YRBS_NATIONAL::1991,YRBS,United States,1991,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1991_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::1993,YRBS_NATIONAL::1993,YRBS,United States,1993,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1993_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::1995,YRBS_NATIONAL::1995,YRBS,United States,1995,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1995_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::1997,YRBS_NATIONAL::1997,YRBS,United States,1997,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1997_National_User_Guide.pdf,source_verified_one_missing_record,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::1999,YRBS_NATIONAL::1999,YRBS,United States,1999,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_1999_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2001,YRBS_NATIONAL::2001,YRBS,United States,2001,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2001_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2003,YRBS_NATIONAL::2003,YRBS,United States,2003,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2003_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2005,YRBS_NATIONAL::2005,YRBS,United States,2005,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2005_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2007,YRBS_NATIONAL::2007,YRBS,United States,2007,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2007_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2009,YRBS_NATIONAL::2009,YRBS,United States,2009,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2009_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2011,YRBS_NATIONAL::2011,YRBS,United States,2011,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2011_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2013,YRBS_NATIONAL::2013,YRBS,United States,2013,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/YRBS_2013_National_User_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2015,YRBS_NATIONAL::2015,YRBS,United States,2015,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/2015_yrbs-data-users_guide_smy_combined.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2017,YRBS_NATIONAL::2017,YRBS,United States,2017,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/2017_YRBS_Data_Users_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2019,YRBS_NATIONAL::2019,YRBS,United States,2019,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/2019_National_YRBS_Data_Users_Guide.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2021,YRBS_NATIONAL::2021,YRBS,United States,2021,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/2021_YRBS_Data_Users_Guide_508.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+YRBS::2023,YRBS_NATIONAL::2023,YRBS,United States,2023,students in grades 9-12 attending public and private schools in the United States,weight,psu,stratum,complex-survey design-based variance accounting for multistage clustering; Taylor linearization supported,prefix PSU and stratum with survey year before pooling,Dataset/YRBS_National_1991_2023/documentation/UserGuide/2023_National_YRBS_Data_Users_Guide508.pdf,source_verified,provisional,"Annual guide identifies WEIGHT, STRATUM, and PSU. Official-layout repairs restored complete 2017/2019 fields; 2021/2023 imports are complete. One 1997 record lacks all three design fields and requires explicit exclusion/handling."
+NSDUH::2021,NSDUH_YOUTH::2021,NSDUH,United States,2021,adolescents aged 12-17,ANALWT2_C1 (single-year); C2/C3/C4 are C1 divided by 2/3/4 for pooled annual averages,VEREP,VESTR_C,Taylor series linearization; 50 df for 2014 onward national PUF estimates,retain full-sample design and specify CATAG2=1 as a survey domain; do not physically subset before variance estimation,"Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf sections 6, 8, 9, 10 and 12; official annual API metadata",source_verified,provisional,"Local C2=C1/2, C3=C1/3, and C4=C1/4 exactly for every row. Use C1 for a single year. VESTR_C and VEREP are complete; domain analysis must retain all PSUs."
+NSDUH::2022,NSDUH_YOUTH::2022,NSDUH,United States,2022,adolescents aged 12-17,ANALWT2_C1 (single-year); C2/C3/C4 are C1 divided by 2/3/4 for pooled annual averages,VEREP,VESTR_C,Taylor series linearization; 50 df for 2014 onward national PUF estimates,retain full-sample design and specify CATAG2=1 as a survey domain; do not physically subset before variance estimation,"Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf sections 6, 8, 9, 10 and 12; official annual API metadata",source_verified,provisional,"Local C2=C1/2, C3=C1/3, and C4=C1/4 exactly for every row. Use C1 for a single year. VESTR_C and VEREP are complete; domain analysis must retain all PSUs."
+NSDUH::2023,NSDUH_YOUTH::2023,NSDUH,United States,2023,adolescents aged 12-17,ANALWT2_C1 (single-year); C2/C3/C4 are C1 divided by 2/3/4 for pooled annual averages,VEREP,VESTR_C,Taylor series linearization; 50 df for 2014 onward national PUF estimates,retain full-sample design and specify CATAG2=1 as a survey domain; do not physically subset before variance estimation,"Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf sections 6, 8, 9, 10 and 12; official annual API metadata",source_verified,provisional,"Local C2=C1/2, C3=C1/3, and C4=C1/4 exactly for every row. Use C1 for a single year. VESTR_C and VEREP are complete; domain analysis must retain all PSUs."
+NSDUH::2024,NSDUH_YOUTH::2024,NSDUH,United States,2024,adolescents aged 12-17,ANALWT2_C1 (single-year); C2/C3/C4 are C1 divided by 2/3/4 for pooled annual averages,VEREP,VESTR_C,Taylor series linearization; 50 df for 2014 onward national PUF estimates,retain full-sample design and specify CATAG2=1 as a survey domain; do not physically subset before variance estimation,"Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf sections 6, 8, 9, 10 and 12; official annual API metadata",source_verified,provisional,"Local C2=C1/2, C3=C1/3, and C4=C1/4 exactly for every row. Use C1 for a single year. VESTR_C and VEREP are complete; domain analysis must retain all PSUs."

research/stage1/survey_design_source_audit.md

@@ -0,0 +1,25 @@
+# Survey-design source audit
+
+Status: **source fields verified; Gate 1 human item review still pending**.
+
+## GSHS
+
+WHO catalog metadata identifies `weight`, `stratum`, and `psu` as the overall analysis weight, sampling stratum, and primary sampling unit. In the seven components containing the primary outcomes, all 21,533 respondents have positive canonical design fields. `sample_weight`, `sampling_psu`, and `sampling_stratum` are numerically identical to `raw_weight`, `raw_psu`, and `raw_stratum`. PSU and stratum must be namespaced by component before pooling.
+
+Sources: WHO GSHS methodology and NCD Microdata catalog; component catalog URLs are retained in `survey_design.csv`.
+
+## YRBS
+
+Annual CDC guides define `WEIGHT`, `STRATUM`, and `PSU` and require software that accounts for the multistage cluster sample. Official fixed-width locations restored the incomplete 2017 and 2019 derived files. The 2017 locations are PDF page 102 (printed page 96); the 2019 locations are PDF page 89 (printed page 86). Both annual full files and the combined selected files now have complete positive design fields for those years. The only remaining local design missingness is one 1997 record with all three fields absent. The 2021 and 2023 official-layout imports are complete.
+
+## NSDUH
+
+The official public-use guide specifies `ANALWT2_C` as the final person-level weight, `VESTR_C` as the pseudo-stratum, `VEREP` as the pseudo-PSU, Taylor series linearization, and 50 degrees of freedom for 2014 onward national PUF estimates. It requires domain analysis without physically dropping non-domain respondents.
+
+The local combined package stores the single-year weight as `ANALWT2_C1`; across all 232,441 rows, `C2=C1/2`, `C3=C1/3`, and `C4=C1/4` exactly, matching pooled annual-average rules. All weight and variance fields are complete and positive.
+
+Source: `Dataset/NSDUH/2023-nsduh-puf-data-users-guide.pdf`, sections 6, 8, 9, 10 and 12.
+
+## Boundary
+
+This audit approves the design-field identities and roles in `survey_design.csv`. It does not approve cross-survey pooling, item equivalence, or human item-review decisions. The single YRBS 1997 design-incomplete record must not silently enter weighted variance estimation.

research/stage1/validate_human_reviews.py

@@ -0,0 +1,99 @@
+"""Fail-closed validator for two actual human primary-outcome reviews."""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import json
+from datetime import date
+from pathlib import Path
+
+
+ALLOWED_DECISIONS = {"approve", "approve_with_correction", "reject", "needs_source"}
+YES_NO = {"yes", "no"}
+LANGUAGE = {"verified", "provisional_accepted", "insufficient"}
+ATTESTATION = "I am a human reviewer and completed this review independently."
+
+
+def read(path: Path) -> list[dict[str, str]]:
+    with path.open(encoding="utf-8-sig", newline="") as handle:
+        return list(csv.DictReader(handle))
+
+
+def validate_packet(path: Path) -> tuple[list[dict[str, str]], list[str]]:
+    rows = read(path)
+    errors = []
+    if len(rows) != 84 or len({r.get("item_version_id", "") for r in rows}) != 84:
+        errors.append(f"{path}: must contain 84 unique item_version_id values")
+    names = {r.get("reviewer_name", "").strip() for r in rows}
+    affiliations = {r.get("reviewer_affiliation", "").strip() for r in rows}
+    if len(names) != 1 or "" in names:
+        errors.append(f"{path}: exactly one nonblank reviewer_name must appear on all rows")
+    if len(affiliations) != 1 or "" in affiliations:
+        errors.append(f"{path}: exactly one nonblank reviewer_affiliation must appear on all rows")
+    for index, row in enumerate(rows, start=2):
+        prefix = f"{path}:{index}"
+        if row.get("decision") not in ALLOWED_DECISIONS:
+            errors.append(f"{prefix}: invalid/blank decision")
+        for field in ("wording_verified", "construct_verified", "population_verified", "response_codes_verified", "skip_logic_verified", "missing_rules_verified"):
+            if row.get(field) not in YES_NO:
+                errors.append(f"{prefix}: {field} must be yes or no")
+        if row.get("language_evidence_status") not in LANGUAGE:
+            errors.append(f"{prefix}: invalid language_evidence_status")
+        try:
+            date.fromisoformat(row.get("review_date", ""))
+        except ValueError:
+            errors.append(f"{prefix}: review_date must be YYYY-MM-DD")
+        if row.get("independence_attestation") != ATTESTATION:
+            errors.append(f"{prefix}: exact independence attestation is required")
+        if row.get("decision") == "approve" and any(row.get(field) != "yes" for field in ("wording_verified", "construct_verified", "population_verified", "response_codes_verified", "skip_logic_verified", "missing_rules_verified")):
+            errors.append(f"{prefix}: approve requires all six verification fields=yes")
+        if row.get("decision") == "approve_with_correction" and not any(row.get(field, "").strip() for field in ("corrected_question_text", "corrected_construct", "corrected_population", "corrected_language", "corrected_response_or_missing_rule")):
+            errors.append(f"{prefix}: approve_with_correction requires at least one correction")
+    return rows, errors
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("reviewer_1", type=Path)
+    parser.add_argument("reviewer_2", type=Path)
+    parser.add_argument("--adjudication", type=Path)
+    parser.add_argument("--output", type=Path, default=Path("research/stage1/human_review_validation.json"))
+    args = parser.parse_args()
+    first, errors = validate_packet(args.reviewer_1)
+    second, second_errors = validate_packet(args.reviewer_2)
+    errors.extend(second_errors)
+    map1 = {r["item_version_id"]: r for r in first}
+    map2 = {r["item_version_id"]: r for r in second}
+    if set(map1) != set(map2):
+        errors.append("Reviewer packets do not contain the same item IDs")
+    name1 = next(iter({r.get("reviewer_name", "").strip() for r in first}), "")
+    name2 = next(iter({r.get("reviewer_name", "").strip() for r in second}), "")
+    if name1 and name1 == name2:
+        errors.append("reviewer_1 and reviewer_2 must be distinct actual people")
+    conflicts = [item for item in sorted(set(map1) & set(map2)) if map1[item].get("decision") != map2[item].get("decision") or map1[item].get("decision") != "approve"]
+    if conflicts:
+        if not args.adjudication or not args.adjudication.exists():
+            errors.append(f"{len(conflicts)} items require adjudication")
+        else:
+            adjudication = {r["item_version_id"]: r for r in read(args.adjudication)}
+            for item in conflicts:
+                row = adjudication.get(item, {})
+                if row.get("final_decision") not in {"approve", "approve_with_correction", "reject"}:
+                    errors.append(f"{item}: valid final_decision required")
+                if not row.get("adjudicator_name", "").strip() or row.get("adjudicator_attestation") != "I am a human adjudicator and resolved this item after reviewing both assessments.":
+                    errors.append(f"{item}: human adjudicator identity and attestation required")
+    result = {
+        "status": "passed" if not errors else "failed",
+        "reviewer_1": name1, "reviewer_2": name2,
+        "items_reviewer_1": len(first), "items_reviewer_2": len(second),
+        "conflicts_or_non_approvals": len(conflicts), "errors": errors,
+        "gate_1_human_review_complete": not errors,
+    }
+    args.output.write_text(json.dumps(result, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+    return 0 if not errors else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

research/stage1/verify_nsduh_youth_attempt.py

@@ -0,0 +1,148 @@
+"""Verify local NSDUH youth-attempt availability against frozen official evidence."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import pandas as pd
+import pyarrow.parquet as pq
+
+
+ROOT = Path(__file__).resolve().parents[2]
+NSDUH = ROOT / "Dataset" / "可直接分析数据包_NSDUH_YRBS" / "NSDUH"
+OUT_JSON = ROOT / "research" / "stage1" / "nsduh_youth_attempt_source_audit.json"
+OUT_MD = ROOT / "research" / "stage1" / "nsduh_youth_attempt_source_audit.md"
+
+TARGETS = [
+    "YUSUICTRY",
+    "YUSUITRYYR",
+    "YUSUICTRYYR",
+    "YUSUICMED",
+    "YUSUIMEDYR",
+    "YUSUIHOSP",
+    "YUSUIHOSYR",
+]
+
+OFFICIAL_SOURCES = [
+    {
+        "year": 2021,
+        "type": "restricted_use_codebook",
+        "url": "https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf",
+        "verified_claim": "YSUI03 maps to YUSUICTRY and asks whether the youth tried to kill themself in the past 12 months.",
+    },
+    {
+        "year": 2022,
+        "type": "restricted_use_codebook",
+        "url": "https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf",
+        "verified_claim": "YSUI03/YUSUICTRY is the attempt item; YSUI04/YUSUICMED and YSUI05/YUSUIHOSP are conditional follow-ups.",
+    },
+    {
+        "year": 2023,
+        "type": "restricted_use_codebook",
+        "url": "https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf",
+        "verified_claim": "YSUI03 maps to YUSUICTRY; the analytic recode is documented as YUSUICTRYYR while composite formulas reference YUSUITRYYR, requiring name reconciliation before restricted-use analysis.",
+    },
+    {
+        "year": 2024,
+        "type": "questionnaire_web_specification",
+        "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf",
+        "verified_claim": "YSUI03 is asked of respondents aged 12–17; YSUI04 is routed only when YSUI03=1 and YSUI05 only when YSUI04=1.",
+    },
+    {
+        "year": 2024,
+        "type": "methodological_summary",
+        "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt56485/2024-nsduh-method-summ-defs/2024-nsduh-method-summ-defs/2024-nsduh-method-summary-defs.htm",
+        "verified_claim": "All adolescents aged 12–17 are asked plan and attempt regardless of serious-thought response; youth variables are not statistically imputed.",
+    },
+    {
+        "year": 2024,
+        "type": "public_use_data_users_guide",
+        "url": "https://www.samhsa.gov/data/sites/default/files/reports/rpt56775/2024-nsduh-puf-data-users-guide.pdf",
+        "verified_claim": "The past-year youth suicide-attempt variable YUSUITRYYR is excluded from the public-use file due to disclosure risk.",
+    },
+]
+
+
+def columns(path: Path) -> set[str]:
+    return set(pq.ParquetFile(path).schema_arrow.names)
+
+
+def main() -> None:
+    dictionary = pd.read_csv(NSDUH / "nsduh_complete_variable_dictionary.csv", dtype=str, keep_default_na=False)
+    dictionary_vars = set(dictionary["variable"])
+    full_vars = columns(NSDUH / "nsduh_2021_2024_full.parquet")
+    selected_vars = columns(NSDUH / "nsduh_2021_2024_selected.parquet")
+    availability = [
+        {
+            "variable": variable,
+            "in_complete_dictionary": variable in dictionary_vars,
+            "in_full_parquet": variable in full_vars,
+            "in_selected_parquet": variable in selected_vars,
+        }
+        for variable in TARGETS
+    ]
+    result = {
+        "schema_version": "1.0",
+        "generated_on": "2026-09-20",
+        "status": "provisional_source_verification",
+        "workflow_stage": 1,
+        "official_sources": OFFICIAL_SOURCES,
+        "local_availability": availability,
+        "verified_item_logic": {
+            "YSUI03": "Asked of all respondents aged 12–17; not conditional on YSUI01 or YSUI02.",
+            "YSUI04": "Asked only if YSUI03=1; medical-attention follow-up.",
+            "YSUI05": "Asked only if YSUI04=1; overnight-hospital follow-up.",
+            "module_location": "Youth mental health service utilization in 2021; youth experiences from 2022 onward.",
+        },
+        "conclusion": "The attempt item was administered, but no raw, recoded, medical-attention, or hospital-follow-up youth-attempt fields are available in the current local public-use package.",
+        "analysis_decision": "Do not use NSDUH as respondent-level external validation for youth suicide attempt with the current data. Retain ideation and plan only; pursue restricted-use access or an aggregate-only alternative if attempt validation is required.",
+        "remaining_review": "Direct PDF page rendering was blocked by HTTP 403. Exact indexed official text and HTML were verified; two-human-reviewer sign-off remains outstanding.",
+    }
+    OUT_JSON.write_text(json.dumps(result, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+
+    table = ["| Variable | Complete dictionary | Full Parquet | Selected Parquet |", "|---|---:|---:|---:|"]
+    for row in availability:
+        table.append(
+            f"| `{row['variable']}` | {str(row['in_complete_dictionary']).lower()} | {str(row['in_full_parquet']).lower()} | {str(row['in_selected_parquet']).lower()} |"
+        )
+    report = f"""# NSDUH youth suicide-attempt source audit
+
+Version: 1.0 | Status: provisional source verification | Date: 2026-09-20
+
+## Result
+
+Official NSDUH materials verify that `YSUI03` asks adolescents aged 12–17 whether they tried to kill themselves in the past 12 months. The source variable is `YUSUICTRY`; `YSUI04`/`YUSUICMED` and `YSUI05`/`YUSUIHOSP` are conditional severity follow-ups. Plan and attempt are asked regardless of the answer to the ideation item.
+
+None of the attempt or follow-up fields is present in the current local public-use dictionary or Parquet schemas:
+
+{chr(10).join(table)}
+
+The 2024 public-use guide explicitly states that the recoded youth attempt variable `YUSUITRYYR` is excluded because of disclosure risk. The current local package is sourced from the official public-use DAS API, which explains why its complete dictionary ends after youth ideation and plan rather than proving the attempt item was never administered.
+
+## Stage 1 decision
+
+- Register `YSUI03`/`YUSUICTRY` as an administered, source-verified, but locally unavailable candidate.
+- Do not derive attempt from ideation wording, plan responses, COVID-conditioned questions, or medical/hospital follow-ups.
+- With current microdata, NSDUH may validate youth ideation and plan only. Youth attempt requires authorized restricted-use data or a separately designed aggregate-data analysis.
+- Keep all records `provisional`; direct PDF page rendering and two-human-reviewer approval remain outstanding.
+
+## Official sources
+
+- [2021 restricted-use codebook]({OFFICIAL_SOURCES[0]['url']})
+- [2022 restricted-use codebook]({OFFICIAL_SOURCES[1]['url']})
+- [2023 restricted-use codebook]({OFFICIAL_SOURCES[2]['url']})
+- [2024 questionnaire web specification]({OFFICIAL_SOURCES[3]['url']})
+- [2024 methodological summary]({OFFICIAL_SOURCES[4]['url']})
+- [2024 public-use data users' guide]({OFFICIAL_SOURCES[5]['url']})
+
+## Reproducibility and limitation
+
+`verify_nsduh_youth_attempt.py` rechecks the repository-local dictionary and both Parquet schemas. SAMHSA's PDF endpoints returned HTTP 403 to direct readers during this action, so the official documents were verified through their indexed official text and the accessible SAMHSA HTML material; visual page-level PDF verification is not claimed.
+"""
+    OUT_MD.write_text(report, encoding="utf-8")
+    print(json.dumps({"variables_checked": len(availability), "all_absent": all(not any(v for k, v in row.items() if k != "variable") for row in availability)}, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

research/stage1/yrbs_2017_2019_design_repair_audit.json

@@ -0,0 +1,93 @@
+{
+  "schema_version": "1.0",
+  "generated_on": "2026-09-20",
+  "status": "passed",
+  "purpose": "Restore YRBS 2017/2019 weight, stratum, and PSU from the official guide's fixed-width locations.",
+  "years": [
+    {
+      "year": 2017,
+      "rows": 14765,
+      "raw_record_lengths": [
+        427
+      ],
+      "raw_file": "Dataset/YRBS_National_1991_2023/raw/XXH2017_YRBS_Data.dat",
+      "raw_sha256": "99f7a87f1f936b21674603064118222247e797323377de7c7365e75a26c6f4b9",
+      "guide_file": "Dataset/YRBS_National_1991_2023/documentation/UserGuide/2017_YRBS_Data_Users_Guide.pdf",
+      "guide_sha256": "3ac5a8b3e62cef9007c5c86f4b8a6eaba15ebd82ef77332335e6670e5387370a",
+      "page_or_section": "PDF page 102 / printed page 96",
+      "positions": {
+        "weight": [
+          387,
+          396
+        ],
+        "stratum": [
+          397,
+          399
+        ],
+        "psu": [
+          400,
+          405
+        ]
+      },
+      "design_nulls_after_repair": {
+        "weight": 0,
+        "stratum": 0,
+        "psu": 0
+      },
+      "weight_min": 0.0442,
+      "weight_max": 4.6923,
+      "weight_sum": 14765.0049,
+      "weight_sum_minus_sample_size": 0.004899999999906868,
+      "output_file": "Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2017_full.parquet",
+      "status": "passed",
+      "selected_table_design_nulls_after_repair": {
+        "weight": 0,
+        "stratum": 0,
+        "psu": 0
+      }
+    },
+    {
+      "year": 2019,
+      "rows": 13677,
+      "raw_record_lengths": [
+        419
+      ],
+      "raw_file": "Dataset/YRBS_National_1991_2023/raw/XXH2019_YRBS_Data.dat",
+      "raw_sha256": "9bfb3e87c519418eb6bd5b491ecfc723c1b21b85dbe796816fcce6b3cea8ca26",
+      "guide_file": "Dataset/YRBS_National_1991_2023/documentation/UserGuide/2019_National_YRBS_Data_Users_Guide.pdf",
+      "guide_sha256": "b60d9e9571939a47fab597448cda537e12e8c712cd20cd332d2ebe6c0fcd25b1",
+      "page_or_section": "PDF page 89 / printed page 86",
+      "positions": {
+        "weight": [
+          386,
+          395
+        ],
+        "stratum": [
+          396,
+          398
+        ],
+        "psu": [
+          399,
+          404
+        ]
+      },
+      "design_nulls_after_repair": {
+        "weight": 0,
+        "stratum": 0,
+        "psu": 0
+      },
+      "weight_min": 0.065,
+      "weight_max": 4.8641,
+      "weight_sum": 13677.0071,
+      "weight_sum_minus_sample_size": 0.007100000000718865,
+      "output_file": "Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2019_full.parquet",
+      "status": "passed",
+      "selected_table_design_nulls_after_repair": {
+        "weight": 0,
+        "stratum": 0,
+        "psu": 0
+      }
+    }
+  ],
+  "decision": "2017 and 2019 design fields are no longer missing in the annual full Parquet files; use WEIGHT with STRATUM and PSU in complex-survey procedures."
+}

research/stage1/yrbs_2017_2019_design_repair_audit.md

@@ -0,0 +1,19 @@
+# YRBS 2017/2019 design-field repair audit
+
+2017 and 2019 design fields are no longer missing in the annual full Parquet files; use WEIGHT with STRATUM and PSU in complex-survey procedures.
+
+## 2017
+
+- rows: 14,765
+- official locations: `{'weight': (387, 396), 'stratum': (397, 399), 'psu': (400, 405)}` (PDF page 102 / printed page 96)
+- design nulls after repair: `{'weight': 0, 'stratum': 0, 'psu': 0}`
+- weight range/sum: 0.0442–4.6923; sum 14765.0049
+
+## 2019
+
+- rows: 13,677
+- official locations: `{'weight': (386, 395), 'stratum': (396, 398), 'psu': (399, 404)}` (PDF page 89 / printed page 86)
+- design nulls after repair: `{'weight': 0, 'stratum': 0, 'psu': 0}`
+- weight range/sum: 0.0650–4.8641; sum 13677.0071
+
+The repair changes only derived Parquet files, which remain reproducible and excluded from Git. Official raw files are never modified.

research/stage1/yrbs_2021_2023_import_audit.json

@@ -0,0 +1,97 @@
+{
+  "schema_version": "1.0",
+  "generated_on": "2026-09-20",
+  "status": "passed_for_import; still provisional for human item review",
+  "method": "Official CDC SAS fixed-width Input positions; raw/archive SHA-256 identity; record-length, domain, design-field, and Parquet round-trip checks.",
+  "years": [
+    {
+      "year": 2021,
+      "source_file": "Dataset/YRBS_National_1991_2023/raw/YRBS_2021_National.dat",
+      "sas_layout": "Dataset/YRBS_National_1991_2023/source_archive/2021_cdc_download/2021XXH-SAS-Input-Program.sas",
+      "sha256": "0a8605d7843fba9cb50e7c0c4094089b0ce2793a9988506971fdae3d9f2a04ae",
+      "archive_copy_identical": true,
+      "record_length": 421,
+      "rows": 17232,
+      "columns": 239,
+      "layout_fields": 237,
+      "output_file": "Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2021_full.parquet",
+      "parquet_roundtrip": "passed",
+      "primary_outcome_value_counts": {
+        "Q26": {
+          "1": 3593,
+          "2": 13334,
+          "<missing>": 305
+        },
+        "Q27": {
+          "1": 2801,
+          "2": 13520,
+          "<missing>": 911
+        },
+        "Q28": {
+          "1": 13820,
+          "2": 993,
+          "3": 525,
+          "4": 114,
+          "5": 121,
+          "<missing>": 1659
+        }
+      },
+      "primary_outcome_domains": {
+        "Q26": "passed",
+        "Q27": "passed",
+        "Q28": "passed"
+      },
+      "design_nonmissing": {
+        "weight": 17232,
+        "stratum": 17232,
+        "psu": 17232
+      },
+      "status": "import_validated"
+    },
+    {
+      "year": 2023,
+      "source_file": "Dataset/YRBS_National_1991_2023/raw/XXH2023_YRBS_Data.dat",
+      "sas_layout": "Dataset/YRBS_National_1991_2023/source_archive/2023_cdc_download/2023XXH-SAS-Input-Program.sas",
+      "sha256": "0a83cba11dc8a0cdf0043aacf0b80478f86cf93a91a8ecb81a276518e486241a",
+      "archive_copy_identical": true,
+      "record_length": 421,
+      "rows": 20103,
+      "columns": 252,
+      "layout_fields": 250,
+      "output_file": "Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2023_full.parquet",
+      "parquet_roundtrip": "passed",
+      "primary_outcome_value_counts": {
+        "Q27": {
+          "1": 4214,
+          "2": 15453,
+          "<missing>": 436
+        },
+        "Q28": {
+          "1": 3212,
+          "2": 15154,
+          "<missing>": 1737
+        },
+        "Q29": {
+          "1": 17341,
+          "2": 1109,
+          "3": 630,
+          "4": 100,
+          "5": 156,
+          "<missing>": 767
+        }
+      },
+      "primary_outcome_domains": {
+        "Q27": "passed",
+        "Q28": "passed",
+        "Q29": "passed"
+      },
+      "design_nonmissing": {
+        "weight": 20103,
+        "stratum": 20103,
+        "psu": 20103
+      },
+      "status": "import_validated"
+    }
+  ],
+  "decision": "YRBS 2021 and 2023 respondent files are released from import-layout quarantine. Primary-outcome items remain provisional pending two human reviewers."
+}

research/stage1/yrbs_2021_2023_import_audit.md

@@ -0,0 +1,25 @@
+# YRBS 2021/2023 official-layout import audit
+
+YRBS 2021 and 2023 respondent files are released from import-layout quarantine. Primary-outcome items remain provisional pending two human reviewers.
+
+## 2021
+
+- rows × columns: 17,232 × 239
+- raw file identical to archived CDC download: yes (`0a8605d7843fba9cb50e7c0c4094089b0ce2793a9988506971fdae3d9f2a04ae`)
+- fixed record length: 421 bytes for every row
+- design completeness: `{'weight': 17232, 'stratum': 17232, 'psu': 17232}`
+- primary outcome domains: `{'Q26': 'passed', 'Q27': 'passed', 'Q28': 'passed'}`
+- output: `Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2021_full.parquet`
+
+## 2023
+
+- rows × columns: 20,103 × 252
+- raw file identical to archived CDC download: yes (`0a83cba11dc8a0cdf0043aacf0b80478f86cf93a91a8ecb81a276518e486241a`)
+- fixed record length: 421 bytes for every row
+- design completeness: `{'weight': 20103, 'stratum': 20103, 'psu': 20103}`
+- primary outcome domains: `{'Q27': 'passed', 'Q28': 'passed', 'Q29': 'passed'}`
+- output: `Dataset/可直接分析数据包_NSDUH_YRBS/YRBS/full_by_year/yrbs_2023_full.parquet`
+
+## Boundary
+
+This resolves the import-layout quarantine only. It does not substitute for two actual human item reviewers or approve design-based variance estimation.

research/stage1/yrbs_primary_outcome_source_audit.md

@@ -0,0 +1,46 @@
+# YRBS primary-outcome source audit
+
+Version: 1.0 | Status: provisional | Generated: 2026-09-20
+
+## Result
+
+All 17 national questionnaires and their annual data user guides were directly cross-checked for suicide ideation, plan, and attempt. The wording and answer options are stable across 1991-2023, but printed questionnaire numbers are not always the same as the variable numbers used in the released data.
+
+The previous registry mapped 21 items in 7 years to the wrong data variable: 1995, 2001, 2003, 2005, 2007, 2009, 2011. The correct columns are present in the annual 1991-2019 full Parquet files, and all observed codes stay within the official response domains. This is a registry/crosswalk defect, not loss of the underlying columns.
+
+## Annual crosswalk
+
+| Year | Data variables (ideation/plan/attempt) | Printed questionnaire numbers | Previous mapping | Data status |
+|---:|---|---|---|---|
+| 1991 | `Q19/Q20/Q21` | 19/20/21 | Q19/Q20/Q21 (verified) | available_full_table |
+| 1993 | `Q24/Q25/Q26` | 23/24/25 | Q24/Q25/Q26 (verified) | available_full_table |
+| 1995 | `Q22/Q23/Q24` | 22/23/24 | Q30/Q31/Q32 (corrected) | available_full_table |
+| 1997 | `Q22/Q23/Q24` | 21/22/23 | Q22/Q23/Q24 (verified) | available_full_table |
+| 1999 | `Q23/Q24/Q25` | 23/24/25 | Q23/Q24/Q25 (verified) | available_full_table |
+| 2001 | `Q24/Q25/Q26` | 25/26/27 | Q25/Q26/Q27 (corrected) | available_full_table |
+| 2003 | `Q24/Q25/Q26` | 25/26/27 | Q25/Q26/Q27 (corrected) | available_full_table |
+| 2005 | `Q24/Q25/Q26` | 26/27/28 | Q26/Q27/Q28 (corrected) | available_full_table |
+| 2007 | `Q24/Q25/Q26` | 25/26/27 | Q25/Q26/Q27 (corrected) | available_full_table |
+| 2009 | `Q24/Q25/Q26` | 25/26/27 | Q25/Q26/Q27 (corrected) | available_full_table |
+| 2011 | `Q25/Q26/Q27` | 27/28/29 | Q27/Q28/Q29 (corrected) | available_full_table |
+| 2013 | `Q27/Q28/Q29` | 27/28/29 | Q27/Q28/Q29 (verified) | available_full_table |
+| 2015 | `Q27/Q28/Q29` | 27/28/29 | Q27/Q28/Q29 (verified) | available_full_table |
+| 2017 | `Q26/Q27/Q28` | 27/28/29 | Q26/Q27/Q28 (verified) | available_full_table |
+| 2019 | `Q26/Q27/Q28` | 26/27/28 | Q26/Q27/Q28 (verified) | available_full_table |
+| 2021 | `Q26/Q27/Q28` | 26/27/28 | Q26/Q27/Q28 (verified) | available_full_table |
+| 2023 | `Q27/Q28/Q29` | 31/32/33 | Q27/Q28/Q29 (verified) | available_full_table |
+
+## Source interpretation
+
+- Data user guides/codebooks govern the released data-variable mapping; printed questionnaire numbers are retained as separate provenance fields.
+- Ideation and plan use 1=Yes and 2=No. Attempt uses 1=0 times, 2=1 time, 3=2 or 3 times, 4=4 or 5 times, and 5=6 or more times.
+- The 2023 printed questionnaire explicitly routes 0 attempts past the injury follow-up. That routing does not alter the primary attempt-frequency response itself.
+- Annual guides report generic Missing counts but do not identify refusal, legitimate skip, data error, or other missing reasons for these primary items. Missing canonicalization therefore remains unresolved.
+
+## Gate 1 decision
+
+Gate 1 remains **in progress**. The 51 YRBS primary-outcome source records have a direct-source crosswalk, clean response options, and validated 1991-2023 full tables. Missing reasons still require the conservative rule, and two actual human reviewers have not yet signed the primary outcomes.
+
+## Reproduction
+
+Run `research/stage1/import_yrbs_2021_2023.py` first, then `research/stage1/audit_yrbs_primary_outcome_sources.py`. The scripts validate official layouts, verify source hashes, check all 1991-2023 annual Parquet schemas, and compare official versus previous mappings.