docs(stage1): add a step-by-step adjudication guide for a first-time adjudicator

Twelve sections covering the single editable file, the two signed files that
must never be touched, safe ways to open a UTF-8 CSV, every one of the 14
columns, the exact attestation string, a worked example, the five decision
groups, the validation command, and what done looks like.

Two prohibitions are stated explicitly: do not edit the signed reviewer files,
and do not run build_human_review_packets.py, which overwrites them with blank
templates. Also flags that adjudicators cannot use needs_source even though
52 rows carry it from reviewer 1.

Every hardcoded string was verified against source: the attestation matches the
validator byte for byte, the allowed final_decision set matches, all 14 columns
are covered with no phantom or missing ones, and all six referenced paths exist.

Corrects an earlier claim in the record. The review_date problem is not one
problem. Reviewer 2 has 2026/9/20 on all 84 rows, a pure formatting issue.
Reviewer 1 has 84 distinct dates incrementing daily to 2026/12/12 - an Excel
drag-fill, mostly future-dated. That column cannot be fixed by reformatting,
since the values themselves are wrong; only reviewer 1 can supply the real date.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.gitattributes

@@ -0,0 +1,11 @@
+# Normalize all text to LF in the repository.
+# Working copies may use CRLF on Windows; git stores and diffs LF so that
+# editor/tool line-ending flips never appear as content changes.
+* text=auto eol=lf
+
+# Explicit binaries: never normalize.
+*.xlsx binary
+*.png  binary
+*.pdf  binary
+*.docx binary
+*.zip  binary

.gitignore

@@ -43,3 +43,9 @@ Thumbs.db
 *.pth
 *.pt
 *.onnx
+
+# Session scratch
+/tmp/
+
+# Windows junction git sees as a symlink, so **/node_modules/ misses it
+/research/experiments/node_modules

.learnings/ERRORS.md

@@ -2,6 +2,327 @@
 
 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**: resolved
+**Area**: infra
+
+### Summary
+The remote rejected the previously authorized HTTPS credential when pushing the Stage 1 source-registry commit.
+
+### Error
+`remote: Failed to authenticate user` / `fatal: Authentication failed`
+
+### Context
+Local commit `fb30b60` was created successfully. Local `main` is one commit ahead of `origin/main`; no remote history changed.
+
+### Suggested Fix
+Reauthorize the `git.jinome.org` entry through Git Credential Manager, then retry `git push`. Do not store a password or token in repository files.
+
+### Metadata
+- Reproducible: yes
+- 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
+
+**Logged**: 2026-09-20
+**Priority**: low
+**Status**: resolved
+**Area**: docs
+
+### Summary
+An exploratory GSHS workbook filter referenced `column` instead of the actual `column_name` field.
+
+### Error
+`KeyError: 'column'`
+
+### Context
+The workbook schema was printed in the same command and showed the correct field name. The failed command was read-only and changed no data.
+
+### Suggested Fix
+Inspect the sheet columns first and filter on `column_name`.
+
+### Metadata
+- Reproducible: yes
+- Related Files: `Dataset/GSHS-全球学生健康调查数据/GSHS/02_documentation/GSHS_数据字典.xlsx`
+- Pattern-Key: runtime.python-exception
+
+### Resolution
+- **Resolved**: 2026-09-20
+- **Notes**: Re-ran the read-only extraction using `column_name` and obtained the intended candidate rows.
+
 ---
 ## [ERR-20260920-028] python-assignment-expression-comprehension
 
@@ -850,3 +1171,100 @@ 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.
+
+---
+
+
+## ERR-20260920-043: Review-source extraction edge cases
+
+- Logged: 2026-09-20; Status: resolved for local extraction; official WHO variable pages remain unavailable in this run.
+- Context: AI-assisted reviewer 1 draft, not human attestation.
+- Errors: source_package mixes file and URL-only entries; assuming source_file caused KeyError. An overlong inline diagnostic expression had a syntax error. Morocco component iso3 is null, so the initial country-specific annotation missed its French source.
+- Resolution: guard optional source_file, use a short script for diagnostics, and identify the component by its observed country/name; corrected the draft and checked all six French-source rows before delivery. PDF word splits were checked against rendered 1993/1995 pages rather than treated as true wording differences. No source data was changed.
+- Remaining external issue: WHO catalog 992 V39/V40/V41 returned cache/read errors; mark direct item checks unverified instead of copying previous audit decisions.
+- Related files: research/stage1/primary_outcome_review_reviewer_1.csv; research/stage1/reviewer_1_ai_review_summary.md.

Progression.md

@@ -1,9 +1,9 @@
 # 项目进度档案
 
-版本：1.7  
+版本：1.26
 建立日期：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 |
@@ -67,7 +67,7 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 - GSHS 现有说明记录主表 673,499 行、637 列、165 项调查、191 个非重叠组件；这些数字目前属于既有质量报告陈述，尚未由本轮执行重算。
 - YRBS 原始库覆盖 1991–2023；现有整理包说明 1991–2019 已生成分析表，2021/2023 仍处于导入布局验证隔离状态。
 - 系统 Python 3.13.7、Pandoc 3.11、31.82 GiB RAM 和 NVIDIA GeForce RTX 5060 Ti 16 GB 已核验；正式项目环境使用 CPython 3.12.14、PyMC 6.3.2、R 4.6.1、mirt/lavaan/survey 栈及 CUDA Toolkit 13.4.2，三套运行验收均通过。
-- 当前根目录不是 Git 仓库；版本化与审计需使用明确的文件哈希和状态档案，或后续经用户授权建立版本控制。
+- 当前根目录已建立 Git 仓库，`main` 跟踪 `origin/main`；远端为 `Jinovo/language-conditioned-psychometric-harmonization-model`，每项推进按强制协议独立提交并推送。
 
 ## 6. 文献初筛结论（尚待矩阵固化）
 
@@ -81,12 +81,13 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 | 优先级 | 问题 | 影响 | 下一处理 |
 |---|---|---|---|
-| P0 | 官方题目文本、回答标签、适用总体和跳题规则尚未逐项核验 | 阶段 1 和确认性分析不能启动 | 在阶段 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、来源、证据层级和项目关系 |
-| P2 | 根目录没有 Git 版本控制 | 变更追踪依赖手工哈希和档案 | 暂不擅自初始化；先维持文件哈希和行动日志 |
+| P0 | NSDUH 的 `YSUI03/YUSUICTRY` 已确认施测，但尝试及严重度字段不在当前本地公开使用数据中；2024 指南明确记录派生尝试变量因披露风险排除 | 当前微数据只能外部验证意念/计划，不能验证尝试 | 不从其他题推导尝试；如核心设计必须使用尝试，评估受限数据申请或预先设计的聚合结果方案 |
+| P1 | Solomon Islands 2023 已有 WHO 官方目录的逐题来源与总体资料，但未取得国家问卷文件/实际施测语言证据 | 不影响该组件的题文/编码来源，但限制语言字段批准 | 保持语言 provisional；在语言 DIF 分析前取得施测语言证据或排除相应主张 |
 
 ## 8. 行动日志
 
@@ -673,9 +674,146 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 - 新证据：GSHS 三个设计候选字段各缺 20 行；YRBS 1997 有 1 行设计字段缺失，2017/2019 的 PSU/stratum 全缺且权重仅部分存在；NSDUH 四个权重列在全部年度均非空且为正，需要官方指南解释适用语义。
 - 质量边界：所有审核状态默认 `provisional`；本次未批准题目等价、构念、缺失重编码、锚题或复杂抽样方差方法；Gate 1 未通过。
 - 工程修复：内联聚合的 Python 语法失败和 pandas 内存耗尽分别记录为已解决的 `ERR-20260920-028`、`ERR-20260920-029`；最终脚本使用标准 CSV 流式扫描。
-- 推送状态：提交后立即推送。
+- 推送状态：`pushed`；提交 `5c31417` 已推送至 `origin/main`。
 - 下一步：建立主要结局来源登记骨架；优先核验 GSHS/NSDUH 的意念、计划、尝试题与适用总体，并追查 YRBS 2017/2019 设计字段缺口。
 
+### A-20260920-054：建立主要结局来源登记骨架
+
+- 时间：2026-09-20
+- 阶段：1（有来源证据的题库和回答层）
+- 动作：完整读取工作流与进度档案；从 GSHS 数据字典、YRBS selected 字典、NSDUH complete 字典及 full/selected Parquet schema 中提取自杀意念、计划、尝试候选；严格分开原始青少年题、派生变量、成人模块、COVID 条件题与复合指标。
+- 输入：GSHS `GSHS_数据字典.xlsx` 的 `Master_Columns`；YRBS `yrbs_selected_variable_dictionary.csv`；NSDUH `nsduh_complete_variable_dictionary.csv` 及 2021–2024 full/selected Parquet schema。
+- 输出：`research/stage1/build_primary_outcome_registry.py`、`primary_outcome_registry.json`、`primary_outcome_registry.md`；更新 `.learnings/ERRORS.md` 的已解决 `ERR-20260920-030`。
+- 检查：脚本通过 `py_compile`；JSON 可解析；65 条原始候选全部为 `provisional`、审核者为空、连接状态为 `not_evaluated`；分布为 GSHS 6 条、YRBS 51 条、NSDUH 8 条；另隔离 8 条 NSDUH 青少年派生记录和 40 条成人/COVID/派生或复合排除记录；语义断言和 `git diff --check` 通过。
+- 新证据：GSHS 自杀尝试同时存在二分类与次数型版本，不能自动合并；YRBS 每个主要构念有 17 个年度候选，2021/2023 仍只保留元数据且数据隔离；NSDUH 本地完整字典只暴露青少年意念与计划，未找到青少年尝试变量，`YSUI03`–`YSUI05` 仅在模块迁移说明中出现。
+- 质量边界：未直接核验年度 PDF/代码本页码；没有把 AI 检查登记为人类审核；没有批准任何构念等价、缺失重编码、题目家族或锚定关系。Gate 1 仍为 `in_progress`。
+- 工程修复：一次只读工作簿筛选错误使用 `column` 而非 `column_name`，无数据改动；修正后成功并记录为已解决的 `ERR-20260920-030`。
+- 提交状态：本地提交 `fb30b60` 已创建。
+- 推送状态：`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 基线）
 
 | 阶段 | 主要工作 | 预计人周 | 主要波动来源 |
@@ -696,8 +834,243 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 下一次行动开始前重新读取 `Document/research-workflow.md` 与本文件。随后：
 
-环境补强已经完成。下一行动进入阶段 1：
+阶段 1 下一行动：
 
-1. 冻结阶段 1 数据实体 schema 与审核状态枚举；
-2. 只读核验 GSHS、YRBS、NSDUH 候选入口的实际结构、行列数和设计字段；
-3. 建立主要结局的来源登记骨架，所有未完成实际双重核查的条目标为 `provisional`。
+1. 由两名实际审核者独立处理 `primary_outcome_human_review_queue.csv`，核对题文、构念、总体、语言、编码、跳题和缺失规则；
+2. 对两位审核者的分歧执行显式裁决，不得由 AI 冒充审核者或自动填写签名；
+3. 审核通过后重建题库/回答层并执行 Gate 1 逐项验收；未签署前保持全部主要结局为 `provisional`。
+
+
+## 11. 本次 AI 辅助预审
+
+### A-20260920-065：完成 reviewer 1 未签署 AI 辅助审查草稿
+
+- 时间：2026-09-20T17:00:00+12:00；阶段1，Gate 1保持 `in_progress`。
+- 动作：按用户要求先核对原始问卷/代码本再填 reviewer 1 表；完整读取工作流和进度，保护行动开始前已有的根目录AGENTS.md删除与本进度旧日志删除。未读取 reviewer 2 决定。
+- 输入：84行模板、396行回答字典、来源路径审计、65份本地PDF/DOCX提取文本及WHO Solomon Islands研究页；原始资料未修改。
+- 输出：`research/stage1/primary_outcome_review_reviewer_1.csv`、`reviewer_1_ai_review_summary.md`；每行明确标识AI草稿，四个人工身份/签署字段为空。
+- 检查：84行、29列、84唯一ID，原11来源列与行序不变；32项建议修订后批准、52项需补来源；单份验证仅170项预期身份/日期/声明缺失，其余字段错误0。抽取断字经代表页渲染解决。
+- 新问题：1995/1997 YRBS总体遗漏Louisiana排除限制；2023 YRBS指南总体表述冲突；2015指南QN29提到不存在的F选项；NSDUH意念题混入编辑Note；GSHS法语引用与英语题干混用、Morocco问卷年份关联待证。数字编码/特殊缺失码未独立核实的条目保持needs_source。
+- 未解决：真实双审与裁决未完成，52项来源缺口未关闭；没有重建题库、回答层或改变Gate状态。
+- 提交/推送状态：本行动文件已检查，准备独立提交；推送结果另行追加记录。既有用户改动不纳入提交。
+- 更正（提交时复核）：本条撰写后，两份审核表已由用户补填真实身份、日期与独立性声明，故“四个人工身份/签署字段为空”仅描述撰写当时状态，提交时已不成立；详见 A-20260920-066。
+- 下一步：用户作为实际reviewer 1逐项核对、补证或改判后填写真实身份、日期及声明；另由第二位实际人员独立审查，随后执行裁决与Gate验收。
+
+
+### A-20260920-066：按 Git 协议整理并提交待提交改动
+
+- 时间：2026-09-20T20:05:28+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：按 `CLAUDE.md` 强制 Git 协议清点工作树、划定提交边界并分离提交；未修改任何已签署的审核行，未重建题库或回答层，未变更 Gate 状态。
+- 输入：`git status --short`、`git diff`、`research/stage1/validate_human_reviews.py`、`CLAUDE.md`、`AGENTS.md`。
+- 检查结果：
+  - 41 个“已修改”文件中 37 个为 LF→CRLF 行尾翻转、内容零变化（`git diff --ignore-cr-at-eol` 为空，`git add --renormalize` 未暂存任何内容）。若直接提交将产生约 2.3 万行无法审计的差异，违反协议第 5 条，故先新增 `.gitattributes`（`* text=auto eol=lf`）归零。
+  - 实际内容变更仅 4 个文件：两份审核表、`.learnings/ERRORS.md`、`Progression.md`。
+  - `validate_human_reviews.py` 返回 `status=failed`，共 169 条错误，均如实记录未规避：168 条为 `review_date` 写作 `2026/9/20` 而校验要求 ISO `YYYY-MM-DD`；1 条为 84 项待裁决。reviewer_1 `Jino Gu` 与 reviewer_2 `Jinghao Guo` 通过“不同实际人员”判定；决定值、六项核验字段、语言证据状态与声明文本全部通过。
+- 输出（提交）：
+  - `85f5dab` chore(repo): normalize line endings and extend ignore boundary —— 新增 `.gitattributes`；`.gitignore` 增补 `/tmp/` 与 `research/experiments/node_modules`（Windows junction，git 记为 symlink，`**/node_modules/` 无法匹配）。
+  - `413b679` review(stage1): record signed primary outcome reviews —— 两份已签署审核表、`ERR-20260920-043` 及三份审核摘要。
+  - 本条记录单独提交。
+- 提交/推送状态：`push_pending`。`git.jinome.org` 在本会话两个执行环境均不可达：设备侧受限 shell 的代理对 CONNECT 返回 HTTP 403，云端容器同样无法建立连接（同环境可达 github.com，故非仓库地址错误）。非凭据问题，未读取、修改或清除任何凭据。三个提交均在本地 `main`，尚未上传。
+- 未解决问题：
+  - `.git/index.lock` 与 `.git/HEAD.lock` 为先前崩溃的 git 进程遗留；本会话无文件删除权限，无法清除。为不丢失已完成工作，提交改用 git 底层命令完成（`write-tree` + `commit-tree`，随后直接写入 `refs/heads/main` 并追加 reflog），未改写任何既有历史。另有探测文件 `.git/refs/heads/.writetest` 为本次可写性测试遗留，属无效 ref 名称，git 忽略，但应一并删除。
+  - `review_date` 格式不合校验要求；84 项裁决未完成；52 项来源缺口未关闭。
+  - `CLAUDE.md` 按用户指示不纳入版本控制，保持未跟踪。
+- 下一步：
+  1. 在可访问 `git.jinome.org` 的环境执行 `git push origin main`，推送上述三个提交，并回填推送结果；
+  2. 删除 `.git/index.lock`、`.git/HEAD.lock`、`.git/refs/heads/.writetest` 后执行 `git reset`，使索引与 `HEAD` 同步；
+  3. 将 `review_date` 改为 ISO `YYYY-MM-DD` 并完成 84 项裁决，再执行 Gate 1 逐项验收。
+
+
+### A-20260920-067：独立复核审核发现并在生成源头修正来源归属
+
+- 时间：2026-09-20T20:25:12+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：不以项目既有审计为准，直接对本地原始资料复核两份已签署审核表所列发现；随后按用户授权范围（仅"来源可证的更正"）在生成脚本层实施修正。未重建任何生成物，未改动已签署的审核行。
+- 输入：`Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf`、`2022NSDUHmrbCAISpecs070722.pdf`、`2023NSDUHmrbWebCAISpecs013123.pdf`、`2024-nsduh-mrb-eng-web-specs.pdf`、`nsduh_complete_variable_dictionary.csv`（9,870 行）、GSHS 摩洛哥/瓦利斯和富图纳英法问卷与实况表、YRBS 1993/1995/1997/1999 National User Guide、`item_bank.csv`、`response_dictionary.csv`、`survey_design.csv`。
+- 检查结果：reviewer 2 findings 所列 10 项可核查断言**全部复核为真**，逐项证据如下。
+  - `YUSUICTRY` 不存在于本地 9,870 行变量字典（`YUSUITHK`、`YUSUIPLN` 存在）；其 9 个编码与 `YUSUITHK` 完全一致，含标签与 missing_type 映射。
+  - 四年 MRB 规范 PDF 均逐字含 `YSUI03 [IF CURNTAGE = 12 - 17] During the past 12 months, did you try to kill yourself?`，题干、总体与跳题因此闭合；工具仅给出 1–4 与 DK/REF。
+  - 2022–2024 意念题 `question_text` 长度 472/472/449 字符且以 "Note: Beginning in 2022…" codebook 变更说明开头；2021 为 195 字符。
+  - 2021 镜像缺陷成立且更严重：工具另有 `YSUINT` 屏——"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."；项目将第一句并入 `YSUI01` 而丢弃第二句，即赋予编码 3、4 合法性的那一句。
+  - `LANGVER` 四年均存在，option_count=2。
+  - 6 行 GSHS 引用法语问卷却存英语题干；两个组件目录均另有英语问卷，摩洛哥英语 PDF 第 32/33/34 项逐字命中，瓦利斯和富图纳英语 docx 三题逐字命中。属引用错误而非题干错误。
+  - 牙买加实况表："A census was used…"，学校应答率 100%；瓦利斯和富图纳实况表（法语）："Un recensement a été utilisé…"，学校应答率 100%，919 人。二者在 `survey_design.csv` 中的权重/PSU/层与 Taylor 处理与加纳两阶段整群样本逐字节相同，且均标记 `source_verified_fields`。
+  - `Dataset/` 下检索 "solomon"/"SLB" 无任何命中；所罗门群岛 3 行引用通用数据字典 `GSHS_数据字典.xlsx`，非国别工具。
+  - 1995 与 1997 National User Guide 均载 "in the fifty states and the District of Columbia, excluding a majority of Louisiana"，1993/1999 无此限制；题库四年均存"全国覆盖"字样。
+  - reviewer 1 独立标注了同一 Louisiana 缺口与引导语/作答提示分离问题，两份审核在关键处相互印证。
+- 输出（提交 `0c9645e`）：修正在生成源头而非生成物，避免下次构建覆盖。
+  - `audit_yrbs_primary_outcome_sources.py`、`build_primary_outcome_package.py`：YRBS 总体字符串改为按年条件化，1995/1997 载明 Louisiana 排除。
+  - `build_primary_outcome_registry.py`：新增 `NSDUH_ATTEMPT_LOCAL_SPECS`，四年各引本地工具 PDF，`source_verification_status` 由 `official_indexed_text_verified_pdf_render_pending` 改为 `local_instrument_pdf_verified`；总体写明 `IF CURNTAGE = 12 - 17`。
+  - 新增 `NSDUH_ATTEMPT_UNATTESTED_CODES`，`add_item` 接受 `unattested` 参数：85/94/97/98/99 的 `derivation_rule` 标注为继承自 `YUSUITHK` 且无来源，`review_status` 置为 `needs_source`；编码未删除。
+  - GSHS 问卷选择器改为优先匹配存储题干语言的工具版本；对全部 6 个组件模拟验证，仅摩洛哥与瓦利斯和富图纳改变，其余四个不变。
+- 检查（构建）：三份脚本均通过 `py_compile`；选择器以真实文档清单模拟验证；未执行任何构建脚本。
+- 提交/推送状态：`push_pending`。`git.jinome.org` 本会话两个执行环境仍返回 HTTP 403 CONNECT，非凭据问题。本地 `main` 现领先 `origin/main` 四个提交：`85f5dab`、`413b679`、`3034718`、`0c9645e`。
+- 未解决问题：
+  - 生成物（`item_bank.csv`、`response_dictionary.csv`、`survey_design.csv`、`primary_outcome_registry.json` 等）相对已修正源头**已过期**；重建会重新生成题库与人工审核队列，属 Gate 相关动作，本轮未授权执行。
+  - 本轮授权范围外、已核实但未修正：牙买加与瓦利斯和富图纳的普查设计处理与 `source_verified_fields` 状态；所罗门群岛无国别工具仍按已验证来源处理；NSDUH 2022–2024 `question_text` 内的 codebook 变更说明与 2021 丢句；`LANGVER` 未用于语言状态。
+  - `review_date` 仍为 `2026/9/20`，校验器要求 ISO；84 项裁决未完成。
+- 下一步：
+  1. 决定是否执行 Stage 1 重建以使生成物与已修正源头一致（需依次运行 YRBS 审计、GSHS 审计、registry、package 四个脚本，并逐项 diff 验证 84 个 item_version_id 不变）；
+  2. 在可访问 `git.jinome.org` 的环境推送四个提交；
+  3. 处理上列未授权修正项、`review_date` 格式与 84 项裁决，再执行 Gate 1 验收。
+
+
+### A-20260920-068：Stage 1 重建尝试——因环境不符而中止
+
+- 时间：2026-09-20T20:29:49+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：按授权准备执行 Stage 1 重建（先备份生成物、再依次运行四个脚本、逐项 diff 验证）。备份已完成，**未运行任何构建脚本**，工作树生成物保持不变。
+- 检查结果（中止理由）：本会话设备侧 Linux shell 的运行环境与项目记录的可复现环境不一致，重建会引入与环境绑定的无声漂移。
+  - 项目锁定：`python-requirements.lock.txt` 为 `pandas==3.0.6`、`numpy==2.5.3`、`pyarrow==25.0.1`；`smoke-test-result.json` 记录解释器为 `3.12.14 ... [MSC v.1944 64 bit (AMD64)]`（Windows）。
+  - 本会话可用：Python 3.10.12、pandas 2.3.3、**无 pyarrow**。`pip install pyarrow` 被代理拒绝（`Tunnel connection failed: 403 Forbidden`），与 `git push` 同一网络限制。
+  - `.venv-research` 仅含 `Scripts/python.exe`，为 Windows 虚拟环境，无法在该 Linux shell 调用。
+  - 四个脚本中 `audit_yrbs_primary_outcome_sources.py` 与 `build_primary_outcome_registry.py` 直接 `import pyarrow.parquet`，缺之无法运行；仅运行其余两个只能落实四项更正中的两项，且会使生成物处于半新半旧的不一致状态。
+  - pandas 2.x 与 3.x 在字符串 dtype 与 CSV 写出行为上存在差异，以 2.3.3 重写题库与回答字典将使生成物与已记录环境不可复现。
+- 输出：无文件变更；备份留存于会话临时目录（不在仓库内），生成物未动。
+- 提交/推送状态：`push_pending`，同 A-20260920-067；本地 `main` 领先 `origin/main` 五个提交。
+- 未解决问题：生成物仍相对已修正源头过期；须在锁定环境中重建后方能一致。
+- 下一步：在 Windows 锁定环境（`E:\Model`）依次执行，四个脚本均无需参数：
+  1. `.venv-research\Scripts\python.exe research\stage1\audit_yrbs_primary_outcome_sources.py`
+  2. `.venv-research\Scripts\python.exe research\stage1\audit_gshs_primary_outcome_components.py`
+  3. `.venv-research\Scripts\python.exe research\stage1\build_primary_outcome_registry.py`
+  4. `.venv-research\Scripts\python.exe research\stage1\build_primary_outcome_package.py`
+  随后核对 `git diff`：预期仅 YRBS 1995/1997 总体字符串、NSDUH 四行 attempt 的 `source_file`/验证状态、attempt 五个编码的 `derivation_rule`/`review_status`、摩洛哥与瓦利斯和富图纳的问卷引用发生变化，且 84 个 `item_version_id` 不变；如出现其他变化应停止并复核。
+
+
+### A-20260920-069：按 Git 协议执行待推送提交——认证失败，未推送
+
+- 时间：2026-09-20T20:33:14+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：按 `CLAUDE.md` 强制 Git 协议，在 Windows 锁定环境（`E:\Model`）执行 A-20260920-066/067/068 记录的待推送动作。行动前完整读取 `Document/research-workflow.md` 与本档案并核对 `git status --short`。未运行任何构建脚本，未改动生成物、题库、回答层或任何已签署审核行，未变更 Gate 状态。
+- 输入：`Document/research-workflow.md`、`Progression.md`、`git status --short`、`git config`、Windows 凭据管理器条目清单。
+- 检查结果：
+  - **网络可达性与前次记录不同。** `git ls-remote --heads origin` 成功返回 `27246a3d8a011cd35dd974527e13957a4f9b34bc refs/heads/main`，与本地 `refs/remotes/origin/main` 一致。A-20260920-066/067 记录的 `HTTP 403 CONNECT` 属受限 shell 与云端容器的网络限制，不适用于本环境；本环境的阻塞点是认证而非连通性。
+  - **推送因认证失败。** `git push origin main` 返回 `remote: Failed to authenticate user` 与 `fatal: Authentication failed for 'https://git.jinome.org/...'`。
+  - **根因定位（未读取、未修改、未清除任何凭据值）。** 凭据助手为 GCM（`credential.helper=manager`，`credential.https://git.jinome.org.provider=generic`）。`cmdkey /list` 显示该站点仅存 `git:https://refresh_token.git.jinome.org` 一条刷新令牌条目，访问令牌条目 `git:https://git.jinome.org` 不存在；GCM 以已失效的刷新令牌静默换取访问令牌失败。本会话环境设有 `GCM_INTERACTIVE=never`、`GIT_TERMINAL_PROMPT=0`、`GIT_ASKPASS` 为空，交互式重新授权在本会话内被禁止，因此 GCM 未弹出登录流程即失败。
+  - **重新授权属用户操作，未由 AI 执行。** 未清除刷新令牌条目，未发起 OAuth 登录，未输入任何凭据。
+  - **清理前次崩溃遗留。** 确认无 `git`/`git-credential-manager` 进程后，删除 A-20260920-066 登记的遗留 `.git/index.lock`（0 字节）与无效 ref 名 `.git/refs/heads/.writetest`（`.git/HEAD.lock` 已不存在），随后 `git reset` 使索引与 `HEAD` 同步。工作树随即仅余未跟踪的 `CLAUDE.md`，无内容丢失。
+- 输出：无研究文件变更；本条记录单独提交。
+- 提交/推送状态：`pushed`（首次尝试 `push_failed`，提交本条记录后重试成功）。本条记录撰写时首次 `git push origin main` 因上述认证失败中止；本条记录以 `96e03e3` 提交后再次执行同一命令即成功，推测 GCM 在两次调用之间以刷新令牌静默换得有效访问令牌，未由 AI 执行任何交互授权或凭据操作。
+- 推送结果（提交后核验）：`27246a3..96e03e3 main -> main`。七个提交按顺序为 `85f5dab`、`413b679`、`3034718`、`0c9645e`、`7cf3c93`、`e4a3c65`、`96e03e3`，均已上传。`git fetch` 后 `HEAD` 与 `origin/main` 同为 `96e03e3cce59ce0139475cf51156e193b27f59fb`，本地领先 0 个提交。A-20260920-066/067/068 登记的 `push_pending` 至此全部清偿。
+- 未解决问题：
+  - 生成物仍相对 A-20260920-067 已修正的源头过期；Stage 1 重建（A-20260920-068 下一步所列四个脚本）尚未执行。
+  - `review_date` 仍为 `2026/9/20`，校验器要求 ISO `YYYY-MM-DD`；84 项裁决未完成；52 项来源缺口未关闭。
+  - `CLAUDE.md` 按用户指示保持未跟踪。
+- 下一步：
+  1. 在锁定环境执行 A-20260920-068 所列四个重建脚本并逐项 diff 验证 84 个 `item_version_id` 不变；
+  2. 修正 `review_date` 格式、完成 84 项裁决，再执行 Gate 1 逐项验收。
+
+
+### A-20260920-070：在锁定环境执行 Stage 1 重建并逐项验证差异
+
+- 时间：2026-09-20T21:48:23+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：执行 A-20260920-067 授权、A-20260920-068 因环境不符中止的 Stage 1 重建。行动前完整读取工作流与本档案并核对 `git status --short`（仅未跟踪 `CLAUDE.md`）。在 Windows 锁定环境 `E:\Model` 以 `.venv-research\Scripts\python.exe` 依次运行四个脚本，使生成物与 A-20260920-067 已修正的源头一致。未改动任何已签署审核行，未变更 Gate 状态。
+- 环境核验（A-20260920-068 中止理由已消除）：实测解释器 `3.12.14 (main, Aug 14 2026, 15:40:22) [MSC v.1944 64 bit (AMD64)]`，与 `smoke-test-result.json` 记录一致；`pandas 3.0.6`、`numpy 2.5.3`、`pyarrow 25.0.1`、`duckdb 1.5.5` 与 `python-requirements.lock.txt` 逐项一致。
+- 事前保护：将 `research/stage1/` 全部 46 个文件备份至会话临时目录（不在仓库内），并记录重建前 SHA-256。运行前静态核对四个脚本的全部写出目标，确认 12 个输出文件中**不含**两份已签署审核表。
+- 输入：`audit_yrbs_primary_outcome_sources.py`、`audit_gshs_primary_outcome_components.py`、`build_primary_outcome_registry.py`、`build_primary_outcome_package.py`（均无参数）。
+- 输出（7 个文件发生变更）：`item_bank.csv`、`response_dictionary.csv`、`survey_design.csv`、`source_conflicts.csv`、`primary_outcome_human_review_queue.csv`、`primary_outcome_registry.json`、`yrbs_primary_outcome_source_audit.json`。
+- 运行摘要：YRBS 审计 17 年/51 题，隔离 0 年、值域失败 0；GSHS 审计 191 组件、7 个含主要结局、行数不匹配 0、观测 673,499 行；registry 候选 66/派生 11/排除 40；package 输出 84 题、396 编码、28 设计行、9 候选连接、32 冲突、84 审核队列。各项计数与 A-20260920-063 记录完全一致。
+- 逐项差异验证（结果：**仅出现四项授权更正，无额外变化**）：
+  - **84 个 `item_version_id` 完全不变**（排序后与 `HEAD` 版本 diff 为空），题库列结构 26 列不变；回答字典 396 行、(`item_version_id`,`raw_code`) 键集合完全一致。
+  - YRBS 1995/1997：`population` 由“United States”改为载明 `excluding a majority of Louisiana`——题库 6 行、`survey_design.csv` 2 行、YRBS 审计 JSON 6 处。
+  - NSDUH 四年 `YUSUICTRY`：`source_file` 由空值改为各年本地 MRB 规范 PDF（题库 4 行、回答字典 36 行）；`source_verification_status` 由 `official_indexed_text_verified_pdf_render_pending` 改为 `local_instrument_pdf_verified`；`population` 载明 `IF CURNTAGE = 12 - 17`；`notes` 同步。
+  - NSDUH 尝试题编码 85/94/97/98/99（5 编码 × 4 年 = 20 行）：`derivation_rule` 标注为继承自 `YUSUITHK` 且无本地字典或 schema 佐证，`review_status` 由 `provisional` 改为 `needs_source`；编码未删除。
+  - GSHS 摩洛哥与瓦利斯和富图纳：问卷引用由 FRENCH/French 版改为存储题干语言对应的 ENGLISH/English 版——题库 6 行、回答字典 24 行、`source_conflicts.csv` 2 行；其余四个 GSHS 组件引用不变。
+  - registry 另新增 `unattested_answer_options` 字段，在 4 行中列出 85/94/97/98/99。
+- 防伪与完整性检查：两份已签署审核表重建前后 SHA-256 **完全一致**（reviewer_1 `cbd79847…`、reviewer_2 `5fe95245…`），裁决表亦未被写入；审核队列仍为 84 行/84 个唯一 ID，其 16 行变更与题库同源。中文路径字节未损坏。
+- Gate 1 接受审计（对重建后生成物重跑 `audit_gate1_acceptance.py`）：`item_bank` 84 行、`response_dictionary` 396 行、`survey_design` 28 行、`construct_ontology`、`responses_long` 919,863 行/80 个有回答题目、`item_links` 9 行、`source_conflicts` 32 行（11 项未关闭）七项全部 `passed`；唯一 `unmet_requirements` 仍精确收敛为 `two_actual_human_reviewers`。`gate1_acceptance_audit.json` 内容与重建前逐字节一致，说明重建未改变 Gate 判定。退出码 1 为未满足项的 fail-closed 信号，非运行错误。
+- 未重建项：`responses_long.parquet` 未重新生成，因本次变更仅涉及来源、总体、备注与审核状态等元数据字段，`raw_code → canonical_code` 映射未变；重跑的 Gate 审计以现有 919,863 行长表通过，可证其仍然一致。
+- 质量边界：生成物与源头一致不等于内容双审完成或抽样设计获批。全部题目仍为 `provisional`，Gate 1 保持 `in_progress`。
+- 提交/推送状态：`pushed`。本次重建的 7 个生成物与本条记录合并为单个提交 `4c7f42b`；首次 `git push` 复现 A-20260920-069 的认证失败，立即重试成功。`git fetch` 后 `HEAD`、`origin/main` 与 `git ls-remote` 三者同为 `4c7f42bfe4a6e477e4ae50bf654063642a8e12df`，本地领先 0 个提交。
+- 工程记录：`git.jinome.org` 的 GCM 凭据在本会话表现为首次推送失败、重试即成功（已两次复现）。属凭据刷新时序问题，非仓库地址或网络问题；未读取、修改或清除任何凭据。
+- 未解决问题：
+  - `review_date` 仍为 `2026/9/20`，验证器要求 ISO `YYYY-MM-DD`，据此 168 行报错。该字段属人工签署内容，按 A-20260920-063 的防伪边界（AI 不填写姓名、日期、决定或声明），**未由 AI 改写**，须由签署人本人确认后修正。
+  - 84 项裁决未完成；52 项来源缺口未关闭；`source_conflicts.csv` 11 项未关闭。
+  - A-20260920-067 列出的授权范围外事项仍未处理：牙买加与瓦利斯和富图纳的普查设计处理、所罗门群岛无国别工具、NSDUH 2022–2024 `question_text` 内的 codebook 说明与 2021 丢句、`LANGVER` 未用于语言状态。
+- 下一步：
+  1. 由签署人确认并将 `review_date` 修正为 ISO `YYYY-MM-DD`，随后重跑 `validate_human_reviews.py`；
+  2. 完成 84 项裁决并据此更新题库审核状态；
+  3. 重跑 Gate 1 逐项验收，全部满足后方可将阶段 1 标为 `passed`。
+
+
+### A-20260920-071：实施两名审核者一致要求的更正并降级未获来源支持的状态
+
+- 时间：2026-09-20T22:02:53+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：行动前完整读取工作流与本档案并核对干净 Git 状态。读取两份已签署审核表，仅实施**两名审核者独立且一致**要求的更正，并对经复核确认没有来源支持的状态做降级。全部修改在生成脚本层，未改动任何已签署审核行，未替任何人裁决。
+- 输入：`primary_outcome_review_reviewer_1.csv`、`primary_outcome_review_reviewer_2.csv`、`item_bank.csv`、`response_dictionary.csv`、`survey_design.csv`、`nsduh_complete_variable_dictionary.csv`、A-20260920-067 已核实的 WHO 实况表证据。
+- **审核一致性统计（本次新发现，须记录）：** 84 行中仅 **21 行两人决定一致**（14 `approve_with_correction` + 7 `needs_source`），**63 行不一致**。不一致分布：`needs_source`/`approve` 27 行、`needs_source`/`approve_with_correction` 18 行、`approve_with_correction`/`approve` 18 行；按调查为 YRBS 45 行、GSHS 18 行。reviewer 1 无一行给出无条件 `approve`，reviewer 2 给出 45 行。75% 的不一致率本身即为需要裁决时重点关注的证据。
+- 实施的更正（均为两人一致要求，且经本次独立复核）：
+  1. **NSDUH 2022/2023/2024 `YUSUITHK` 删除代码本编辑说明。** 原 `question_text` 以 "Note: Beginning in 2022, questions ... were moved from the youth mental health service utilization section to the youth experiences section." 开头，该句是 DAS 字典的编辑注记，非受访者所见。reviewer 1 要求“删除开头的模块迁移 Note”，reviewer 2 标为 `CORRECTION (wording)`。删除后被删文本**逐字保留**在 `notes` 中，未丢失。
+  2. **NSDUH 2021 `YUSUITHK` 修正题干末尾多余空格**（`kill yourself ?` → `kill yourself?`），reviewer 2 明确指出该空格属 DAS 渲染artifact。
+  3. **Solomon Islands 三题 `review_status` 由 `provisional` 降为 `needs_source`。** 两名审核者均独立返回 `needs_source`，理由为 `Dataset/` 下不存在该国问卷、代码本或实况表（递归检索 "solomon"/"SLB" 无命中），其唯一引用为通用 `GSHS_数据字典.xlsx`。降级逻辑写为“无国别问卷则 needs_source”，不针对国别硬编码。
+- 实施的状态降级（依据 A-20260920-067 已核实证据，非本次新主张）：
+  4. **牙买加与瓦利斯和富图纳 `design_status` 由 `source_verified_fields` 降为 `census_variance_treatment_unresolved`。** 两地实况表载明使用普查（"A census was used…" / "Un recensement a été utilisé…"，学校应答率 100%），但其权重/PSU/层与 Taylor 线性化计划此前与两阶段整群样本组件逐字节相同。权重/PSU/层字段予以保留，仅将方差处理标为未决，并新增 2 条 `design_treatment_not_established_for_census` 冲突记录。`variance_method` 本身未改动——那是需要独立证据的阶段 4 统计决定，不在本次范围。
+- 未实施及理由（**明确不做**，留待人工）：
+  - **2021 缺失的作答提示句未补写。** 2022–2024 含 "You can answer 'I'm not sure' or 'I don't want to answer' to any question."，2021 无此句，而 2021 同样提供编码 3（I'm not sure）与 4（I don't want to answer）。两名审核者均指出应补回。但向 `question_text` 写入题目文本属改写官方原文，违反工作流 §5.2“不补写成官方原文”，已作为待人工处理项登记，未由 AI 执行。
+  - **84 项裁决未执行。** 按 A-20260920-063 防伪边界，裁决属人工决定。
+  - `LANGVER` 仍未用于语言状态；NSDUH 2021 与 2022–2024 的题干结构差异仍存。
+- 检查：两个脚本 `py_compile` 通过后运行 registry 与 package。计数 84 题 / 396 编码 / 28 设计行 / 9 连接 / **34 冲突（新增 2）** / 84 队列。逐项 diff 验证：84 个 `item_version_id` 不变、列结构不变、回答字典 396 行**完全未变**；题库仅 `question_text` 4 行、`text_hash` 4 行、`notes` 3 行、`review_status` 3 行变化。`text_hash` 由 Gate 审计独立重算校验通过，确认哈希与新文本一致（2022/2023/2024 修正后题干相同，哈希合并为同一值，符合预期）。两份已签署审核表 SHA-256 保持 `cbd79847…` 与 `5fe95245…` 不变。
+- Gate 1 接受审计：七项机器交付物全部 `passed`（冲突 34 行、未关闭 13 项），唯一 `unmet_requirements` 仍为 `two_actual_human_reviewers`。Gate 1 保持 `in_progress`。
+- 提交/推送状态：`pushed`。提交 `21c7e21`（9 个脚本/生成物 + 本条记录），已推送至 `origin/main`；本次首次推送即成功。
+- 未解决问题：63 行审核不一致待裁决；`review_date` 仍为 `2026/9/20`（非 ISO）；2021 提示句缺口；13 项未关闭冲突；`LANGVER` 未使用。
+- 下一步：
+  1. 由两名审核者裁决 63 行不一致决定，并确认 `review_date` 的 ISO 格式修正；
+  2. 裁决完成后重跑 `validate_human_reviews.py` 与 Gate 1 验收；
+  3. Gate 1 通过后方可进入阶段 2（可行性、可识别性和连接审计）。
+
+
+### A-20260921-072：分析 63 项不一致审核的结构（只读诊断）
+
+- 时间：2026-09-21T00:02:42+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：应用户要求列出待裁决的 63 行，并分析其结构。纯只读诊断，未修改任何文件、未替任何人裁决。服务于 A-20260920-071 已登记的裁决待办。
+- 输入：两份已签署审核表、`primary_outcome_review_adjudication.csv`、YRBS `source_archive` 目录、`2023XXH-Formats-Program.sas`。
+- **核心发现：63 项不是 63 个独立判断，而是 3 个成组的政策问题。**
+  - **组 1（27 行，YRBS 2005/2007/2009/2011/2013/2015/2017/2019/2023 × 3 题）** R1 `needs_source` / R2 `approve`。分歧轴唯一且一致：R1 在 **27/27** 行声明本年度“数字值标签/格式映射”未独立核实，仅接受问卷的 A/B 选项顺序，拒绝沿用项目字典；R2 认为年度 Data Users Guide 代码本（1=Yes, 2=No）已足够。裁决问题：**年度指南代码本是否构成数值编码映射的充分来源，还是必须取得该年度官方格式程序/原始值标签。**
+  - **组 2（18 行，6 个有来源的 GSHS 组件 × 3 题）** R1 `needs_source` / R2 `approve_with_correction`。分歧轴不同：R1 要求组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射；R2 以国别代码本加实测分布双重核验编码（如加纳 1=901、2=2744、缺失=151，且组件行数 3,796 与实况表参与人数一致），其 correction 指向 population 占位符——实况表就在所引问卷同一目录内，认为属不必要的证据缺口。裁决问题：**实况表能否关闭 population 缺口；代码本加实测分布是否满足“直接映射来源”的要求。**
+  - **组 3（18 行，YRBS 1991/1993/1999/2001/2003/2021 × 3 题）** R1 `approve_with_correction` / R2 `approve`。此组 R1 的数值标签检查**已完成**：15 行经年度代码本核对，3 行（2021 Q26–Q28）经官方 `2021XXH-Formats-Program.sas` 的 H26S/H27S/H28S 格式核对。残余分歧仅为 `language provisional_accepted`（仅接受英语来源文本，不证明实际施测语言）是否构成需更正的缺陷。裁决问题：**语言状态的既有记法是否可接受。**
+- **可用证据关闭的缺口（非裁决问题）：** 组 1 与组 3 的差别只在 R1 是否完成同一项检查。本地 `Dataset/YRBS_National_1991_2023/source_archive/` 仅存 2021 与 2023 两个年度的 CDC 格式程序。其中 **2023 的 `2023XXH-Formats-Program.sas` 本地即有**，且已逐项确认含 `$H27S`/`$H28S`/`$H29S`（`"1"="Yes"`、`"2"="No"`、`" "="Missing"`、`other="** Data Error **"`），与 R1 在 2021 所用来源同类同位置。故组 1 的 **YRBS 2023 Q27/Q28/Q29 三行属可由本地官方来源关闭的证据缺口，而非需要判断的分歧**；其余 24 行（2005–2019）本地无格式程序，关闭需另取 CDC 官方文件。
+- 附带记录的审核者观察（尚未处理）：R2 指出加纳组件的意念与计划缺失数同为 151，而其余组件两题互不相同，建议对原始 WHO 文件做一次确认；并提示派生二分变量 `raw_mh_b_*` 不得被静默替换为施测题目。
+- **裁决表状态：** `primary_outcome_review_adjudication.csv` 84 行**全部为空**，包括本可由机器填充的 `reviewer_1_decision`、`reviewer_2_decision`、`conflict_reason` 三列。这三列属两份已签署审核的派生事实，不属人工签署字段；其余 `adjudicator_name`、`adjudication_date`、`final_*`、`adjudication_notes`、`adjudicator_attestation` 属人工字段，必须留空。
+- 检查：未写入任何文件；两份已签署审核表未读写改动，SHA-256 未变。Gate 1 状态未变。
+- 未解决问题：63 行裁决未执行；`review_date` 非 ISO；2021 提示句缺口；13 项未关闭冲突。
+- 下一步：
+  1. 建议先以本地 `2023XXH-Formats-Program.sas` 关闭 YRBS 2023 三行的数值标签缺口，将组 1 的裁决量由 27 降至 24；
+  2. 经用户授权后填充裁决表的三列派生字段（人工签署字段保持空白）；
+  3. 由裁决人按三个政策问题成组裁决，而非逐行判断。
+
+
+### A-20260921-073：填充裁决表的派生列
+
+- 时间：2026-09-21T00:15:15+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：行动前完整读取工作流与本档案并核对干净 Git 状态。按 A-20260921-072 的下一步，填充 `primary_outcome_review_adjudication.csv` 中可由机器推导的三列，使裁决人可在单一表内工作。未替任何人裁决，未填写任何人工签署字段。
+- **重大安全发现（本次阻止的破坏性操作）：** 按项目惯例本应“在生成源头修正”，即运行 `build_human_review_packets.py`。经运行前静态检查，该脚本第 39–40 行会以**空白模板覆盖** `primary_outcome_review_reviewer_1.csv` 与 `primary_outcome_review_reviewer_2.csv`——即两份已签署审核表。**该脚本未被运行。** 任何后续会话若因“重建生成物”的惯性运行它，将不可逆地销毁两名审核者的全部 84 行签署工作。已改为新增专用脚本，且该脚本不写入审核表。
+- 输入：两份已签署审核表、`primary_outcome_review_adjudication.csv`、`validate_human_reviews.py` 第 74 行的裁决判定规则。
+- 输出：新增 `populate_adjudication_table.py`；更新 `primary_outcome_review_adjudication.csv`；生成 `human_review_validation.json`。
+- 填充范围与边界：
+  - **已填（派生事实，非签署内容）：** `reviewer_1_decision`、`reviewer_2_decision`、`conflict_reason`，共 84 行 × 3 = 252 个单元格。
+  - **保持空白（人工签署字段）：** `adjudicator_name`、`adjudication_date`、`final_decision`、`final_question_text`、`final_construct`、`final_population`、`final_language`、`final_response_or_missing_rule`、`adjudication_notes`、`adjudicator_attestation`，经检查 10 个字段非空计数**均为 0**。
+  - 脚本设计为只写派生列、保留任何已存在的人工值，并在结束前重算两份签署表的 SHA-256，一旦变化即以 `FATAL` 退出。
+- `conflict_reason` 依 `validate_human_reviews.py` 的实际规则生成（决定不一致 **或** reviewer_1 非 plain `approve`），只陈述机械理由与双方决定，不写入任何解释或倾向：63 行为“决定不一致”，21 行为“两人一致但非 plain approve”。**84 行全部需要裁决**，与该规则一致（reviewer 1 无一行 plain `approve`）。
+- 检查：`py_compile` 通过；运行输出 `rows=84`、`derived_cells_written=252`、`items_requiring_adjudication=84`、`existing_adjudicator_values_preserved=0`、`signed_packets_unchanged=true`。两份签署表 SHA-256 保持 `cbd79847…`、`5fe95245…`。裁决表仍为 84 行，`item_version_id` 集合三文件一致。
+- 验证器状态（带 `--adjudication` 运行）：`status=failed`，336 条错误——168 条 `review_date` 非 ISO，84 条 `final_decision` 缺失，84 条裁决人身份/声明缺失。后两类共 168 条**全部为人工必填项**，非机器可补。与既往记录的 169 条不构成回归：此前一次未传 `--adjudication`，验证器以单条聚合错误短路；本次进入逐行检查阶段。本次填充不减少错误数，其作用是使裁决表可用。
+- 未解决问题：84 项裁决待人工执行；`review_date` 非 ISO（属签署字段，未由 AI 修改）；`build_human_review_packets.py` 的覆盖风险尚未加防护；13 项未关闭冲突；2021 提示句缺口。
+- 下一步：
+  1. 建议为 `build_human_review_packets.py` 增加 fail-closed 防护，禁止覆盖已签署的审核表（本次未授权，未实施）；
+  2. 由裁决人按 A-20260921-072 的三个政策问题成组填写 `final_decision`、身份、日期与声明；
+  3. 完成后重跑验证器与 Gate 1 验收。
+
+
+### A-20260921-074：编写裁决操作指南并发现 reviewer 1 日期为拖拽填充伪值
+
+- 时间：2026-09-21T00:22:59+12:00；阶段 1，Gate 1 保持 `in_progress`。
+- 动作：行动前完整读取工作流与本档案并核对干净 Git 状态。按用户要求编写面向零基础裁决人的分步指南；撰写过程中逐项核对指南内所有硬编码字符串与路径。未修改任何审核表或生成物，未替任何人裁决。
+- 输出：新增 `research/stage1/adjudication_instructions.md`（12 节），与既有 `human_review_instructions.md` 同目录同语言同风格。
+- 指南内容要点：唯一可编辑文件与两份只读签署文件的边界；Excel 破坏 UTF-8 与日期的两类风险及三种安全打开方式；14 个列的逐列说明（4 列已填禁改、4 列必填、5 列仅在 `approve_with_correction` 时填、1 列建议填）；`final_decision` 仅允许 `approve`/`approve_with_correction`/`reject`；逐行操作步骤与实例；按五个分组批量裁决；验证命令与错误对照表；完成标准。
+- **明确写入指南的两条禁令：** 不得编辑两份签署审核表；不得运行 `build_human_review_packets.py`（该脚本会以空白模板覆盖两份签署表）。
+- **裁决人不得使用 `needs_source`。** 验证器第 82 行仅接受三值，而 reviewer 1 有 52 行为 `needs_source`。指南明确说明这 52 行必须收敛为三值之一，并说明 `reject` 是工作流允许的正当结果。
+- 事实核验（全部通过）：裁决人声明串与验证器第 84 行逐字节一致；`final_decision` 允许值集与验证器一致；指南提及的列与 CSV 的 14 列**完全互相覆盖**（无虚构列、无遗漏列）；6 个引用路径全部存在；五个分组行数 27+18+18+14+7=84。
+- **本次新发现（更正此前记录）：** 此前记录与说明将 `review_date` 问题一律描述为“`2026/9/20` 非 ISO 格式”。逐行核对后该描述**仅对 reviewer 2 成立**（84 行同为 `2026/9/20`）。**reviewer 1 的 84 行是 84 个互不相同的日期**，自 `2026/9/20` 起逐日递增至 `2026/12/12`，为 Excel 拖拽填充（drag-fill）特征；其中绝大多数晚于当前日期 2026-09-21，属未来日期，首行之后不可能是真实审核日期。
+- **该发现改变修复性质：** reviewer 1 的日期**不能以格式规范化修复**，因为值本身错误而非仅形状错误。此前提出的“将 `review_date` 改为 ISO”对 reviewer 1 并不适用——那会把拖拽产生的伪日期固化为合法 ISO 日期。真实日期只能由 reviewer 1 本人提供。指南第 10 节已按此改写。
+- 检查：指南所有断言经脚本核对；未运行任何构建脚本；两份签署审核表未读写改动。Gate 1 状态未变。
+- 未解决问题：84 项裁决待人工执行；reviewer 1 日期需本人提供真实值、reviewer 2 日期需本人授权改格式；`build_human_review_packets.py` 覆盖风险未加防护；13 项未关闭冲突；2021 提示句缺口。
+- 下一步：
+  1. 将本指南与裁决表交付裁决人；
+  2. 请 reviewer 1 提供真实审核日期，请 reviewer 2 授权日期格式更正；
+  3. 裁决完成后重跑验证器与 Gate 1 验收。

research/stage1/Human Reviewer 2 findings.txt

@@ -0,0 +1,15 @@
+The four NSDUH attempt rows can't be signed as they stand. Blank source_file, remote SAMHSA URLs, and the project's own audit admits those endpoints returned 403 and that page-level verification "is not claimed" — so nobody read them. But Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf is sitting right there with YSUI03 [IF CURNTAGE = 12 – 17] During the past 12 months, did you try to kill yourself?, which closes wording, population and skip logic immediately. What doesn't close: YUSUICTRY appears in no local dictionary or schema, yet the response dictionary asserts nine codes for it including 85/94/97/98/99 — unattested, and they look copied from YUSUITHK.
+
+NSDUH ideation 2022–2024 has a codebook change-note ("Note: Beginning in 2022, questions YSUI01… were moved…") stored inside question_text. Never read to a respondent, and it feeds text-similarity linking. 2021 has the mirror-image defect — it drops a sentence the instrument actually contained.
+
+The NSDUH language gap is already solved in your own data. LANGVER (1=English, 2=Spanish) is present for all four years, and the spec opens by asking the respondent which language they want. "Not established" understates what you have.
+
+Six GSHS rows cite the French questionnaire but store English text (Morocco and Wallis and Futuna both ship English and French). Item numbers match in both, so it's a mis-citation, not wrong wording — but the cited file doesn't contain the stored text.
+
+Jamaica and Wallis and Futuna were censuses, not cluster samples, yet survey_design.csv gives them identical weight/stratum/PSU Taylor treatment and marks it source_verified_fields.
+
+Solomon Islands has no instrument anywhere under Dataset/ — searching "solomon" and "SLB" returns nothing. Its wording is inherited from the core GSHS form, not read from a Solomon Islands one.
+
+YRBS 1995 and 1997 excluded a majority of Louisiana per their user guides; the population string claims plain national coverage.
+
+The YRBS block otherwise held up well — all 51 wordings matched verbatim, and the variable numbering that looks off at a glance (2023: printed item 31, variable Q27) is correct in all seventeen years, checked against each guide rather than assumed. GSHS codes verified twice: Ghana's codebook reproduces cell-for-cell against GSHS.csv, and every component's row count matches its fact sheet.

research/stage1/Reviewer_1_summary.md

@@ -0,0 +1,35 @@
+# Reviewer 1 审查记录
+
+日期：2026-09-20。
+
+## 覆盖与判断口径
+
+84 个题目实例均填写了建议决定、六项核验、语言状态和逐行说明；原有 11 个来源/题目标识字段及行序保持不变。按需要填写修订字段，不适用的修订字段留空。
+
+| 调查 | 修订后批准建议 | 需补来源 | 合计 |
+|---|---:|---:|---:|
+| GSHS | 0 | 21 | 21 |
+| YRBS | 24 | 27 | 51 |
+| NSDUH | 8 | 4 | 12 |
+| 合计 | 32 | 52 | 84 |
+
+`no` 表示原字段尚有问题或本次证据不足，不必然表示题目错误。`approve_with_correction` 仍需实际审核和裁决。`missing_rules_verified=yes` 对 GSHS/YRBS 仅确认保守保留 unknown missing，不表示可区分所有缺失原因。`provisional_accepted` 仅接受英语来源文本供题目整理，不证明实际受访语言、便利措施或跨语言测量等价。
+
+## 本次直接证据
+
+- 重新提取 65 份本地 PDF/DOCX 的文本，针对主要结局及相关说明核对；并非逐页全文人工阅读。包括 17 年 YRBS 问卷与 17 份年度指南，六个 GSHS 组件的问卷/代码本，以及 NSDUH CAI/web specifications 和公用代码本。提取中使用既有审计的路径来定位，但没有直接继承其通过结论。
+- YRBS 51 个题干中，49 个可在空白标准化后直接匹配；1993/1995 意念题的断字问题通过渲染页确认。2003 指南变量号 `Q24` 在抽取文本中断行为 `Q2 4`，已回查第9页。年度题号和发布变量号分开记录。
+- 视觉核对 YRBS 1993/1995 问卷第6页、2023 指南第6页，以及 NSDUH 2024 web specification PDF第588页（印刷第576页）。未将其他页声称为视觉核验。
+- NSDUH 2021–2024 年 CAI 的 `YSUI01–YSUI03` 都以 `CURNTAGE=12–17` 为条件。计划、尝试不要求意念为是。公用意念/计划的九种代码对照2021代码本第551–552页、2022代码本第479页及2021–2024合并代码本第447页。合并代码本没有替代年度问卷的路由核验。
+- Solomon Islands 本轮读取了 [WHO catalog 992研究页](https://extranet.who.int/ncdsmicrodata/index.php/catalog/992)，确认总体与抽样说明；三个逐题URL未成功读取。因此这三行题文、编码和跳题未登记为本轮已核实，旧审计不能替代本次直接检查。
+
+## 需要优先处理的问题
+
+1. **1995/1997 YRBS总体限制：** 各年度指南PDF第3页注明排除 Louisiana 的大部分地区。对应六行填写了总体修订建议。
+2. **2023 YRBS来源冲突：** 指南第4–5页描述全国高中总体，第6页却给出36州、三个部落政府、五个领地和21个学区。渲染证实这是原文件内容，三行暂为 `needs_source`；需另核官方方法报告或更正，不能据此自行改成局部调查。
+3. **2005–2019 YRBS数值映射：** 八个年度共24行已核对题文、选项与变量号，但本轮没有逐项读取其发布文件的原始数字值标签/格式程序。A–E的顺序不是充分的1–5映射证据，故 `response_codes_verified=no`。1991–2003直接代码本、2021/2023官方SAS格式程序的数字值标签已读取。
+4. **2015 YRBS尝试题指南笔误候选：** PDF第29页列A–E五个选项，QN29分母/分子文字却提到F。保留五级原始频次，不能添加第六个观测选项；需记录并裁决该来源内部差异。
+5. **NSDUH意念题上下文混入正文：** 2022–2024字段含模块迁移的编辑说明。四年均建议将核心题干、引导语与施测模式上下文分开保存；2021 CAI/web引导语存在差异。
+6. **NSDUH尝试题：** 年度问卷可验证题干、选项1–4和年龄路由，但本轮未直接读取年度受限代码本中的 `YUSUICTRY` 数值标签及特殊缺失码。不得从意念/计划复制85/94/97/98/99作为已核实规则。这四行保留 `needs_source`。本次未重新扫描公用Parquet，数据不可用的说法明确归属既有项目审计。
+7. **GSHS法语来源：** Morocco、Wallis and Futuna的六行引用法语问卷，题文却为英语参考。修订栏填法语原文并要求另存英语reference。法语计划题的“思考如何”与英语“制订计划”不能直接视为严格测量等价。Morocco问卷文件/页眉为2022而组件/代码本为2023，版本关联需补证据。
+8. **GSHS总体、数值映射与语言：** 六个组件的精确采样纳入条件未在本次问卷核对中解决；所有七组件的实际施测语言仍缺证据，英语/法语/蒙古语文件存在不等于证明每名受访者的施测语言。原始代码本的字母选项到发布数字编码需补独立映射证据；蒙古语未完成语言专家核验。

research/stage1/adjudication_instructions.md

@@ -0,0 +1,279 @@
+# Gate 1 adjudication instructions
+
+This document assumes you have never opened this project before. Follow it in order.
+
+## 1. What you are being asked to do
+
+Two people already reviewed the same 84 survey questions independently. They recorded a
+decision for each question. They disagreed on 63 of them, and on the other 21 they agreed but
+did not give a plain approval.
+
+You are the **adjudicator**. For each of the 84 rows you read both reviewers' reasoning and
+record one final decision. You are the tie-breaker and the final word.
+
+Nothing in the project moves forward until this is done. Gate 1 is blocked on it, and every
+later stage is blocked on Gate 1.
+
+You must be a **real person**, and you must not be either of the two reviewers.
+
+## 2. The one file you edit
+
+```
+research/stage1/primary_outcome_review_adjudication.csv
+```
+
+That is the only file you change. Do not edit anything else.
+
+You will also **read** these two files, because the adjudication file does not contain the
+reviewers' reasoning:
+
+```
+research/stage1/primary_outcome_review_reviewer_1.csv
+research/stage1/primary_outcome_review_reviewer_2.csv
+```
+
+> **Never edit, re-save, or "clean up" those two files.** They carry signatures. If they
+> change at all, the review has to be done again from scratch.
+
+> **Never run `build_human_review_packets.py`.** It overwrites both reviewer files with blank
+> templates and destroys all of their work permanently.
+
+## 3. Opening the file without corrupting it
+
+The file is a UTF-8 CSV. Excel damages this kind of file in two specific ways, and it has
+already happened once on this project.
+
+**Danger 1 - dates.** If you type `2026-09-21` into Excel, it may silently rewrite it as
+`2026/9/21`. That format is rejected. This exact bug is currently sitting in the reviewer
+files and is blocking validation.
+
+**Danger 2 - non-English text.** The reviewer notes contain Chinese. If Excel saves as plain
+`CSV`, that text turns into garbage permanently.
+
+Pick one of these three options.
+
+**Option A - a plain text editor (safest).** Open the file in VS Code, Notepad++, or similar.
+No auto-formatting, no encoding surprises. Harder to read, impossible to corrupt.
+
+**Option B - Excel, done carefully.**
+
+1. Open Excel first, with no file loaded.
+2. `Data` -> `From Text/CSV`, pick the file.
+3. Set `File Origin` to **65001: Unicode (UTF-8)**.
+4. Click `Transform Data`, set **every** column type to **Text**, then `Close & Load`.
+5. When saving, choose **CSV UTF-8 (Comma delimited)**, not plain `CSV`.
+
+**Option C - Google Sheets.** `File` -> `Import` -> `Upload`, and set every date cell's format
+to `Plain text` before typing. Download as `.csv` when finished.
+
+If you are not confident, use Option A.
+
+## 4. What the columns mean
+
+**Already filled in for you. Do not change these.**
+
+| Column | Meaning |
+|---|---|
+| `item_version_id` | The unique ID of the survey question. Your key to look things up. |
+| `reviewer_1_decision` | What reviewer 1 concluded. |
+| `reviewer_2_decision` | What reviewer 2 concluded. |
+| `conflict_reason` | Why this row needs you. |
+
+**You fill these in. Required on every row.**
+
+| Column | What to put |
+|---|---|
+| `final_decision` | One of exactly three values. See section 5. |
+| `adjudicator_name` | Your real full name. Identical on all 84 rows. |
+| `adjudication_date` | The date you decided, as `YYYY-MM-DD`, e.g. `2026-09-21`. |
+| `adjudicator_attestation` | One exact sentence. See section 6. |
+
+**You fill these in only when your decision is `approve_with_correction`.** Put the corrected
+value in whichever ones you are fixing, and leave the rest blank.
+
+| Column | Use when you are correcting... |
+|---|---|
+| `final_question_text` | the wording of the question |
+| `final_construct` | what the question is measuring |
+| `final_population` | who was asked |
+| `final_language` | the language evidence |
+| `final_response_or_missing_rule` | the answer codes or missing-data rules |
+
+**Optional but strongly encouraged.**
+
+| Column | What to put |
+|---|---|
+| `adjudication_notes` | One or two sentences on *why* you decided this way. |
+
+Write notes especially where you sided against a reviewer. Someone will read this in a year
+and needs to understand your reasoning without you in the room.
+
+## 5. The three values you may use
+
+`final_decision` must be **exactly** one of these, lowercase, no spaces:
+
+| Value | Meaning | Consequence |
+|---|---|---|
+| `approve` | The row is correct as recorded. | The question enters the analysis as-is. |
+| `approve_with_correction` | Usable, but something must be fixed first. | You must fill at least one `final_*` column. |
+| `reject` | Not usable. | The question is excluded from the analysis. |
+
+> **The trap.** Reviewers were allowed a fourth value, `needs_source`, meaning "I cannot
+> verify this yet." **You are not.** 52 rows say `needs_source` from reviewer 1, and you
+> cannot pass that forward. For each one you must decide: is the evidence good enough
+> (`approve`), good enough once fixed (`approve_with_correction`), or not good enough
+> (`reject`)?
+>
+> `reject` is a legitimate, expected outcome. The project explicitly allows negative findings.
+> Excluding a question you cannot verify is better science than admitting one you cannot.
+
+## 6. The attestation sentence
+
+Copy this into `adjudicator_attestation` on every row, character for character:
+
+```
+I am a human adjudicator and resolved this item after reviewing both assessments.
+```
+
+No extra spaces, no changed punctuation, no rewording. The checker compares it exactly and
+rejects anything else.
+
+## 7. How to do one row
+
+1. Take the `item_version_id`, for example `YRBS::2013::Q27`.
+2. Find that same ID in `primary_outcome_review_reviewer_1.csv` and read its `review_notes`.
+3. Find the same ID in `primary_outcome_review_reviewer_2.csv` and read its `review_notes`.
+4. Decide which reviewer is right, or chart a middle course.
+5. In the adjudication file, on that row, fill `final_decision`, `adjudicator_name`,
+   `adjudication_date`, `adjudicator_attestation`, plus any `final_*` columns if correcting,
+   plus `adjudication_notes`.
+6. Repeat 83 more times.
+
+Worked example. On `YRBS::2013::Q27`, reviewer 1 said `needs_source` because the numeric
+answer codes for that year were never checked against an official source. Reviewer 2 said
+`approve` because the annual Data Users Guide lists `1=Yes, 2=No`. You decide whether the
+guide counts as sufficient. If yes, write `approve`. If you want the official SAS format
+program checked first, write `reject` or `approve_with_correction` and say so in the notes.
+
+## 8. Do it in groups, not one at a time
+
+The 84 rows are not 84 separate puzzles. They fall into five blocks, and every row in a block
+turns on the same question. Decide the block, then apply it.
+
+### Group A - 27 rows - reviewer 1 `needs_source`, reviewer 2 `approve`
+
+`YRBS 2005 Q24-Q26 | 2007 Q24-Q26 | 2009 Q24-Q26 | 2011 Q25-Q27 | 2013 Q27-Q29 | 2015 Q27-Q29 | 2017 Q26-Q28 | 2019 Q26-Q28 | 2023 Q27-Q29`
+
+**The question:** is the annual Data Users Guide codebook enough to establish the numeric
+answer codes, or must the year's official SAS format program be checked?
+
+**Worth knowing:** for YRBS **2023** the official format program is already on disk at
+`Dataset/YRBS_National_1991_2023/source_archive/2023_cdc_download/2023XXH-Formats-Program.sas`,
+and it defines `1=Yes`, `2=No`, blank = `Missing`. Those 3 rows can be settled by looking, not
+by judging. The other 24 rows cover years with no such file stored locally.
+
+### Group B - 18 rows - reviewer 1 `needs_source`, reviewer 2 `approve_with_correction`
+
+All 6 sourced GSHS components (Morocco, Ghana, India, Jamaica, Mongolia, Wallis and Futuna)
+times 3 questions each.
+
+**The question:** reviewer 1 wants the sampling ages/grades, the actual language used, and a
+direct letter-to-number code mapping. Reviewer 2 verified the codes against the country
+codebook *and* the observed data distribution, and argues the fact sheet in the same folder
+already answers the population question. Is that enough?
+
+### Group C - 18 rows - reviewer 1 `approve_with_correction`, reviewer 2 `approve`
+
+`YRBS 1991 Q19-Q21 | 1993 Q24-Q26 | 1999 Q23-Q25 | 2001 Q24-Q26 | 2003 Q24-Q26 | 2021 Q26-Q28`
+
+**The question:** here the codes *were* verified. The only gap left is that the language is
+recorded as "English source text accepted, actual language of administration unproven." Does
+that count as a defect needing correction, or is it acceptable as recorded?
+
+### Group D - 14 rows - both reviewers `approve_with_correction`
+
+`YRBS 1995 Q22-Q24 | 1997 Q22-Q24 | NSDUH 2021-2024 YUSUITHK and YUSUIPLN`
+
+Both agree a fix is needed, so this is mostly confirmation. **Several fixes here are already
+applied** - the YRBS 1995/1997 Louisiana exclusion, and the removal of a codebook note that
+had been wrongly stored as question wording. Check what is already fixed before asking for it
+again.
+
+**Still outstanding in this group:** the 2021 NSDUH ideation question is missing the sentence
+that the 2022-2024 versions carry, telling respondents they may answer "I'm not sure" or
+"I don't want to answer" - even though 2021 still offers those two answer codes. Both
+reviewers asked for it back. It was deliberately not added, because writing official question
+wording is your call, not an automated one. If you want it restored, put the exact sentence in
+`final_question_text`.
+
+### Group E - 7 rows - both reviewers `needs_source`
+
+`GSHS Solomon Islands x 3 | NSDUH 2021-2024 YUSUICTRY x 4`
+
+Both reviewers independently found no usable source. For Solomon Islands there is no country
+questionnaire, codebook, or fact sheet anywhere in the dataset. For the NSDUH attempt
+question, the variable is absent from the public-use data entirely.
+
+Remember you cannot write `needs_source`. These rows need `approve`,
+`approve_with_correction`, or `reject`.
+
+## 9. Checking your work
+
+Run this from the project root, `E:\Model`:
+
+```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
+```
+
+It prints a list of problems. Each line names the file, the row number, and what is wrong.
+Fix them and run it again. Repeat until the adjudication errors are gone.
+
+Common messages and what they mean:
+
+| Message | Fix |
+|---|---|
+| `valid final_decision required` | That row's `final_decision` is blank or misspelled. Use exactly `approve`, `approve_with_correction`, or `reject`. |
+| `human adjudicator identity and attestation required` | `adjudicator_name` is blank, or the attestation sentence does not match exactly. |
+| `review_date must be YYYY-MM-DD` | **Not yours.** See section 10. |
+
+## 10. One thing you cannot fix
+
+You will see **168 errors reading `review_date must be YYYY-MM-DD`**. These are not your rows
+and not your fault. They come from the two signed reviewer files, 84 rows each.
+
+The two files are wrong in different ways, and the difference matters:
+
+- **Reviewer 2** has `2026/9/20` on all 84 rows. Only the separator is wrong; the date itself
+  is consistent. That is purely a formatting problem.
+- **Reviewer 1** has **84 different dates**, one per row, incrementing by a day from
+  `2026/9/20` all the way to `2026/12/12`. This is the signature of an Excel drag-fill: a date
+  was typed once and dragged down the column, and Excel counted upward. Most of those dates
+  are in the future and none of them after the first can be the real review date.
+
+So reviewer 1's column cannot simply be reformatted - the *values* are wrong, not just their
+shape. Only reviewer 1 can say what the true date or dates were.
+
+Both live in signed files. Only the reviewers themselves can authorize changing them, because
+those are signature fields. Leave them alone and report them.
+
+**This means the validator will still say `failed` even after you finish perfectly.** That is
+expected. Your work is complete when every `final_decision`, adjudicator identity, and
+attestation error is gone and only the 168 `review_date` errors remain.
+
+## 11. Rules that invalidate the work
+
+- You must be a real person, not an AI, and not either reviewer.
+- Do not copy a reviewer's decision without reading both sides.
+- Do not edit the two reviewer files, for any reason.
+- Do not run `build_human_review_packets.py`.
+- Do not leave `final_decision` blank on any row.
+- Your name, date, and attestation must be identical on all 84 rows.
+
+## 12. When you are finished
+
+Tell the project maintainer that adjudication is complete. They will re-run the Gate 1
+acceptance audit and, once the remaining `review_date` issue is resolved, Gate 1 can close and
+Stage 2 can begin.
+
+The completed file contains personal attestations. Have it checked before it is committed or
+shared.

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.",
-            "GSHS design fields are candidates and require survey-specific source verification.",
-            "NSDUH year-specific weight selection and variance usage require confirmation against the combined-file guide.",
+            "YRBS 2021 and 2023 have validated annual full Parquet files but are not appended to the legacy 1991-2019 selected table.",
+            "One YRBS 1997 record lacks weight, stratum, and PSU; 2017/2019 design fields were restored from official fixed-width locations.",
+            "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,260 @@
+"""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],
+                    # 1995 and 1997 National User Guides state the frame covers "the fifty states
+                    # and the District of Columbia, excluding a majority of Louisiana". 1993 and 1999
+                    # carry no such restriction.
+                    "population": (
+                        "students in grades 9-12 attending public and private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana; detailed eligibility remains subject to annual design review"
+                        if str(year) in {"1995", "1997"}
+                        else "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,519 @@
+"""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)
+
+
+# WHO GSHS fact sheets state a census was used for these two components
+# ("A census was used..." / "Un recensement a ete utilise..."), each with a 100%
+# school response rate. They currently carry the same weight/PSU/stratum fields
+# and Taylor-linearization plan as the two-stage cluster samples, which is not
+# established for a census. The fields are retained; the variance treatment is
+# marked unresolved rather than source-verified.
+GSHS_CENSUS_COMPONENTS = {
+    "JAM_2023_GSHS_v01::jam_st_cath_2023",
+    "WLF_2023_GSHS_v01::wlf_2023",
+}
+
+BASE_DESIGN_NOTE = (
+    "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."
+)
+
+CENSUS_DESIGN_NOTE = (
+    " The WHO fact sheet for this component reports a census with a 100% school "
+    "response rate. Design-based variance under a census is not the same as under "
+    "the two-stage cluster samples, and no source establishes the Taylor "
+    "linearization plan here; resolve before any design-based variance estimate."
+)
+
+
+def gshs_design_note(component_id: str) -> str:
+    if component_id in GSHS_CENSUS_COMPONENTS:
+        return BASE_DESIGN_NOTE + CENSUS_DESIGN_NOTE
+    return BASE_DESIGN_NOTE
+
+
+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,
+                 unattested: list[str] | None = None) -> None:
+        # Codes listed in `unattested` appear in the delivered data but are attested by no
+        # local dictionary or schema for this variable; mark them instead of silently
+        # presenting them as sourced.
+        unattested_codes = {str(c) for c in (unattested or [])}
+        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": (
+                    "code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable"
+                    if str(code) in unattested_codes
+                    else "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": "needs_source" if str(code) in unattested_codes else "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 []
+        questionnaires = [d for d in documents if "questionnaire" in d.get("role", "").lower()]
+        # question_text below is the English core GSHS wording, so cite the instrument that
+        # actually contains it. Components shipping several language versions (Morocco, Wallis
+        # and Futuna) list every version, and taking the first one cited a French questionnaire
+        # for English text. Other-language versions stay recorded in source_language_evidence.
+        questionnaire = (
+            next((d for d in questionnaires if "english" in d.get("role", "").lower()), None)
+            or next((d for d in questionnaires if d.get("role", "").strip().lower() == "questionnaire"), None)
+            or (questionnaires[0] if questionnaires else None)
+        )
+        source_file = questionnaire.get("source_file", "") if questionnaire else ""
+        source_url = "" if source_file else component.get("catalog_url", "")
+        # No country questionnaire, codebook or fact sheet ships for this component, so its
+        # only citation is the generic GSHS data dictionary. Both primary-outcome reviewers
+        # independently returned needs_source for all three of its items.
+        item_review_status = "provisional" if questionnaire else "needs_source"
+        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": item_review_status,
+                "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": "",
+        })
+        if component["component_id"] in GSHS_CENSUS_COMPONENTS:
+            conflicts.append({
+                "conflict_id": f"GSHS_CENSUS_DESIGN::{component['component_id']}",
+                "survey": "GSHS", "year": str(component.get("collection_start", ""))[:4],
+                "component_id": component["component_id"], "source_variable": "all_primary_outcomes",
+                "conflict_type": "design_treatment_not_established_for_census",
+                "source_a": component.get("catalog_url", ""),
+                "source_b": "WHO GSHS country fact sheet (census statement, 100% school response rate)",
+                "description": "The fact sheet reports a census, but weight/PSU/stratum handling and the Taylor linearization plan are recorded identically to the two-stage cluster-sample components.",
+                "resolution": "unresolved; design_status downgraded to census_variance_treatment_unresolved pending a source-based variance decision",
+                "analysis_consequence": "Exclude from design-based variance estimates until resolved; descriptive use must state the census basis.",
+                "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": "census_variance_treatment_unresolved" if component["component_id"] in GSHS_CENSUS_COMPONENTS else "source_verified_fields",
+            "notes": gshs_design_note(component["component_id"]),
+            "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,
+            # See 1995/1997 National User Guides: frame excludes a majority of Louisiana.
+            "population": (
+                "students in grades 9-12 attending public and private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana"
+                if year in {"1995", "1997"}
+                else "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,
+            unattested=source.get("unattested_answer_options"))
+        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

@@ -0,0 +1,408 @@
+"""Build a provisional, source-linked registry for the three primary outcomes.
+
+This script deliberately does not approve cross-survey equivalence, recode
+responses, or substitute AI review for the two required human reviewers.
+"""
+
+from __future__ import annotations
+
+import html
+import json
+import re
+from collections import Counter
+from pathlib import Path
+
+import pandas as pd
+import pyarrow.parquet as pq
+
+
+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"
+
+PRIMARY_CONSTRUCTS = {"suicide_ideation", "suicide_plan", "suicide_attempt"}
+GSHS_CONSTRUCT = {
+    "raw_mh_considersui": "suicide_ideation",
+    "raw_mh_plansui": "suicide_plan",
+    "raw_mh_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"}
+# Local MRB specification PDFs that carry YSUI03 verbatim, e.g. 2021 web specs:
+#   "YSUI03 [IF CURNTAGE = 12 - 17] During the past 12 months, did you try to kill yourself?"
+# Verified by direct render of each file; this closes wording, population and skip logic.
+NSDUH_ATTEMPT_LOCAL_SPECS = {
+    2021: "Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf",
+    2022: "Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf",
+    2023: "Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf",
+    2024: "Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf",
+}
+
+# The instrument offers only codes 1-4 plus DK/REF for YSUI03. The five dataset
+# missing codes below are inherited from YUSUITHK and are attested by no local
+# dictionary or schema for this variable (YUSUICTRY is absent from all of them).
+NSDUH_ATTEMPT_UNATTESTED_CODES = ["85", "94", "97", "98", "99"]
+
+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:
+    return html.unescape(str(value or "")).strip()
+
+
+# The DAS variable dictionary prefixes some youth suicide items with a codebook
+# editorial note about section moves. That note was never shown to respondents,
+# so it is stripped from question_text and kept separately. Both primary-outcome
+# reviewers issued approve_with_correction requiring this removal.
+CODEBOOK_NOTE = re.compile(
+    r"^(Note:\s*Beginning in \d{4},.*?were moved from the youth mental health "
+    r"service utilization section to the youth experiences section\.)\s*"
+)
+
+
+def split_codebook_note(text: str) -> tuple[str, str | None]:
+    match = CODEBOOK_NOTE.match(text)
+    if not match:
+        return text, None
+    return text[match.end():].strip(), match.group(1)
+
+
+def normalize_stem_spacing(text: str) -> str:
+    """Drop the stray space the DAS rendering leaves before a final '?'."""
+    return re.sub(r"\s+\?$", "?", text)
+
+
+def parse_json_object(value: object) -> object:
+    text = clean_text(value)
+    if not text:
+        return None
+    try:
+        return json.loads(text)
+    except json.JSONDecodeError:
+        return {"unparsed_source_text": text}
+
+
+def parquet_columns(path: Path) -> set[str]:
+    return set(pq.ParquetFile(path).schema_arrow.names)
+
+
+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(set(GSHS_CONSTRUCT) | set(GSHS_DERIVED))].copy()
+    records: list[dict] = []
+    derived_records: list[dict] = []
+    for row in frame.sort_values("ordinal").to_dict("records"):
+        variable = row["column_name"]
+        common = {
+            "survey": "GSHS",
+            "year": None,
+            "source_variable": variable,
+            "population": "school-attending students; exact component ages/grades pending source review",
+            "time_window": "past 12 months",
+            "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 plus component-specific questionnaire/codebook references in component audit",
+            "present_in_local_data": True,
+            "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",
+        }
+        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.",
+                }
+            )
+            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]:
+    audit = json.loads(YRBS_AUDIT.read_text(encoding="utf-8"))
+    records = []
+    for row in sorted(audit["items"], key=lambda item: (item["year"], item["construct"])):
+        year = row["year"]
+        records.append(
+            {
+                "survey": "YRBS",
+                "year": year,
+                "source_variable": row["source_variable"],
+                "construct": row["construct"],
+                "record_type": "raw_candidate",
+                "population": row["population"],
+                "time_window": row["time_window"],
+                "question_text": row["question_text"],
+                "answer_options": row["answer_options"],
+                "source_file": row["questionnaire_source_file"],
+                "data_guide_source_file": row["data_guide_source_file"],
+                "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": row["data_status"],
+                "source_verification_status": "direct_questionnaire_and_data_user_guide_reviewed",
+                "review_status": "provisional",
+                "reviewer_1": None,
+                "reviewer_2": None,
+                "link_status": "not_evaluated",
+                "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
+
+
+def build_nsduh() -> tuple[list[dict], list[dict], list[dict]]:
+    source = NSDUH_DIR / "nsduh_complete_variable_dictionary.csv"
+    frame = pd.read_csv(source, dtype=str, keep_default_na=False)
+    full_cols = parquet_columns(NSDUH_DIR / "nsduh_2021_2024_full.parquet")
+    selected_cols = parquet_columns(NSDUH_DIR / "nsduh_2021_2024_selected.parquet")
+    raw_records: list[dict] = []
+    derived_records: list[dict] = []
+    excluded_records: list[dict] = []
+
+    def common(row: dict, construct: str, record_type: str) -> dict:
+        variable = row["variable"]
+        stem, codebook_note = split_codebook_note(clean_text(row["original_question_or_definition"]))
+        stem = normalize_stem_spacing(stem)
+        return {
+            "survey": "NSDUH",
+            "year": int(row["year"]),
+            "source_variable": variable,
+            "construct": construct,
+            "record_type": record_type,
+            "population": "youth module; exact age/eligibility and skip logic pending codebook review",
+            "time_window": "past 12 months",
+            "question_text": stem or None,
+            "codebook_note_removed": codebook_note,
+            "source_label": clean_text(row["official_title"]),
+            "source_file": str(source.relative_to(ROOT)).replace("\\", "/"),
+            "source_url": clean_text(row["official_source"]),
+            "page_or_section": variable,
+            "present_in_full_table": variable in full_cols,
+            "present_in_selected_table": variable in selected_cols,
+            "source_verification_status": "official_api_metadata_reviewed_codebook_pending",
+            "review_status": "provisional",
+            "reviewer_1": None,
+            "reviewer_2": None,
+            "link_status": "not_evaluated",
+        }
+
+    for row in frame[frame["variable"].isin(NSDUH_YOUTH_RAW)].to_dict("records"):
+        item = common(row, NSDUH_YOUTH_RAW[row["variable"]], "raw_candidate")
+        note = "Keep 'not sure' and refusal/nonresponse distinct until skip and missing rules are verified."
+        if item.get("codebook_note_removed"):
+            note += (
+                " A codebook editorial note about the 2022 section move was removed from"
+                f" question_text and is retained here verbatim: {item['codebook_note_removed']}"
+            )
+        item["notes"] = note
+        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 (instrument condition IF CURNTAGE = 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": NSDUH_ATTEMPT_LOCAL_SPECS.get(year),
+                "source_url": source_url,
+                "page_or_section": "YSUI03",
+                "unattested_answer_options": list(NSDUH_ATTEMPT_UNATTESTED_CODES),
+                "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": "local_instrument_pdf_verified",
+                "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, per the local MRB specification. Codes 85/94/97/98/99 are inherited from YUSUITHK and unattested for this variable. 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
+        item["notes"] = "Derived/recode variable; do not count as an independent administered item."
+        derived_records.append(item)
+
+    exclusion_mask = frame["variable"].str.match(r"^(SUICTHNK|SUIPLANYR|IRSUITRYYR|IRCOSUITRYYR|YUCOSUI|COSUI|ADSUIT)")
+    for row in frame[exclusion_mask].to_dict("records"):
+        variable = row["variable"]
+        reason = "adult_module"
+        if "COSUI" in variable:
+            reason = "covid_conditioned"
+        elif variable.startswith(("IR", "AD")):
+            reason = "adult_derived_or_composite"
+        excluded_records.append(
+            {
+                "survey": "NSDUH",
+                "year": int(row["year"]),
+                "source_variable": variable,
+                "source_label": clean_text(row["official_title"]),
+                "exclusion_reason": reason,
+                "status": "excluded_from_primary_youth_item_candidates",
+            }
+        )
+    return raw_records, derived_records, excluded_records
+
+
+def render_markdown(registry: dict) -> str:
+    records = registry["candidate_records"]
+    counts = Counter((r["survey"], r["construct"]) for r in records)
+    lines = [
+        "# Primary outcome source registry",
+        "",
+        "Version: 1.4 | Status: provisional | Generated: 2026-09-20",
+        "",
+        "## Scope and decision boundary",
+        "",
+        "This registry captures source-linked candidates for suicide ideation, plan, and attempt. It is a development artifact, not an approved item bank. No row has completed the two-human-reviewer requirement, no cross-survey link is approved, and no missing or skip code has been canonically recoded.",
+        "",
+        "## Candidate coverage",
+        "",
+        "| Survey | Ideation | Plan | Attempt | Current evidence boundary |",
+        "|---|---:|---:|---:|---|",
+    ]
+    for survey in ["GSHS", "YRBS", "NSDUH"]:
+        boundary = {
+            "GSHS": "Three administered items occur in 7/191 components; six local source packages plus WHO catalog metadata cover all seven.",
+            "YRBS": "51 annual candidates directly cross-checked; 21 prior mappings corrected; 2021/2023 data remain quarantined.",
+            "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} |"
+        )
+    lines += [
+        "",
+        "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 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.",
+        "- 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.",
+        "- 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 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",
+        "",
+        "Run `research/stage1/build_primary_outcome_registry.py` in the locked research environment. The script reads repository-local dictionaries and Parquet schemas and rewrites this report plus `primary_outcome_registry.json`.",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def main() -> None:
+    gshs, gshs_derived = build_gshs()
+    yrbs = build_yrbs()
+    nsduh_raw, nsduh_derived, nsduh_excluded = build_nsduh()
+    registry = {
+        "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": gshs_derived + nsduh_derived,
+        "excluded_nsduh_records": nsduh_excluded,
+        "availability_constraints": [
+            {
+                "survey": "NSDUH",
+                "construct": "suicide_attempt",
+                "status": "administered_but_unavailable_in_local_public_use_package",
+                "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.",
+                "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": {
+            "human_reviewers_required": 2,
+            "ai_review_is_human_review": False,
+            "default_review_status": "provisional",
+            "cross_survey_equivalence_default": "not_evaluated",
+        },
+    }
+    OUT_JSON.write_text(json.dumps(registry, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    OUT_MD.write_text(render_markdown(registry), encoding="utf-8")
+    print(json.dumps({
+        "candidate_records": len(registry["candidate_records"]),
+        "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)),
+    }, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

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": 34,
+      "open": 13
+    },
+    "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/human_review_validation.json

@@ -0,0 +1,347 @@
+{
+  "status": "failed",
+  "reviewer_1": "Jino Gu",
+  "reviewer_2": "Jinghao Guo",
+  "items_reviewer_1": 84,
+  "items_reviewer_2": 84,
+  "conflicts_or_non_approvals": 84,
+  "errors": [
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:2: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:3: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:4: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:5: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:6: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:7: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:8: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:9: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:10: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:11: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:12: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:13: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:14: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:15: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:16: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:17: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:18: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:19: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:20: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:21: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:22: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:23: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:24: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:25: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:26: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:27: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:28: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:29: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:30: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:31: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:32: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:33: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:34: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:35: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:36: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:37: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:38: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:39: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:40: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:41: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:42: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:43: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:44: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:45: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:46: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:47: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:48: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:49: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:50: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:51: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:52: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:53: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:54: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:55: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:56: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:57: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:58: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:59: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:60: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:61: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:62: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:63: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:64: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:65: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:66: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:67: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:68: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:69: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:70: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:71: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:72: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:73: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:74: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:75: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:76: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:77: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:78: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:79: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:80: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:81: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:82: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:83: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:84: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_1.csv:85: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:2: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:3: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:4: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:5: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:6: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:7: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:8: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:9: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:10: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:11: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:12: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:13: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:14: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:15: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:16: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:17: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:18: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:19: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:20: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:21: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:22: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:23: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:24: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:25: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:26: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:27: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:28: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:29: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:30: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:31: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:32: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:33: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:34: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:35: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:36: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:37: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:38: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:39: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:40: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:41: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:42: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:43: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:44: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:45: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:46: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:47: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:48: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:49: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:50: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:51: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:52: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:53: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:54: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:55: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:56: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:57: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:58: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:59: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:60: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:61: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:62: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:63: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:64: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:65: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:66: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:67: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:68: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:69: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:70: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:71: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:72: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:73: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:74: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:75: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:76: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:77: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:78: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:79: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:80: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:81: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:82: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:83: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:84: review_date must be YYYY-MM-DD",
+    "research\\stage1\\primary_outcome_review_reviewer_2.csv:85: review_date must be YYYY-MM-DD",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui: valid final_decision required",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui: valid final_decision required",
+    "GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui: valid final_decision required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui: valid final_decision required",
+    "GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui: valid final_decision required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui: valid final_decision required",
+    "GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui: valid final_decision required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui: valid final_decision required",
+    "GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui: valid final_decision required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui: valid final_decision required",
+    "GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui: valid final_decision required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui: valid final_decision required",
+    "GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui: human adjudicator identity and attestation required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui: valid final_decision required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui: human adjudicator identity and attestation required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui: valid final_decision required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui: human adjudicator identity and attestation required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui: valid final_decision required",
+    "GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui: human adjudicator identity and attestation required",
+    "NSDUH::2021::YUSUICTRY: valid final_decision required",
+    "NSDUH::2021::YUSUICTRY: human adjudicator identity and attestation required",
+    "NSDUH::2021::YUSUIPLN: valid final_decision required",
+    "NSDUH::2021::YUSUIPLN: human adjudicator identity and attestation required",
+    "NSDUH::2021::YUSUITHK: valid final_decision required",
+    "NSDUH::2021::YUSUITHK: human adjudicator identity and attestation required",
+    "NSDUH::2022::YUSUICTRY: valid final_decision required",
+    "NSDUH::2022::YUSUICTRY: human adjudicator identity and attestation required",
+    "NSDUH::2022::YUSUIPLN: valid final_decision required",
+    "NSDUH::2022::YUSUIPLN: human adjudicator identity and attestation required",
+    "NSDUH::2022::YUSUITHK: valid final_decision required",
+    "NSDUH::2022::YUSUITHK: human adjudicator identity and attestation required",
+    "NSDUH::2023::YUSUICTRY: valid final_decision required",
+    "NSDUH::2023::YUSUICTRY: human adjudicator identity and attestation required",
+    "NSDUH::2023::YUSUIPLN: valid final_decision required",
+    "NSDUH::2023::YUSUIPLN: human adjudicator identity and attestation required",
+    "NSDUH::2023::YUSUITHK: valid final_decision required",
+    "NSDUH::2023::YUSUITHK: human adjudicator identity and attestation required",
+    "NSDUH::2024::YUSUICTRY: valid final_decision required",
+    "NSDUH::2024::YUSUICTRY: human adjudicator identity and attestation required",
+    "NSDUH::2024::YUSUIPLN: valid final_decision required",
+    "NSDUH::2024::YUSUIPLN: human adjudicator identity and attestation required",
+    "NSDUH::2024::YUSUITHK: valid final_decision required",
+    "NSDUH::2024::YUSUITHK: human adjudicator identity and attestation required",
+    "YRBS::1991::Q19: valid final_decision required",
+    "YRBS::1991::Q19: human adjudicator identity and attestation required",
+    "YRBS::1991::Q20: valid final_decision required",
+    "YRBS::1991::Q20: human adjudicator identity and attestation required",
+    "YRBS::1991::Q21: valid final_decision required",
+    "YRBS::1991::Q21: human adjudicator identity and attestation required",
+    "YRBS::1993::Q24: valid final_decision required",
+    "YRBS::1993::Q24: human adjudicator identity and attestation required",
+    "YRBS::1993::Q25: valid final_decision required",
+    "YRBS::1993::Q25: human adjudicator identity and attestation required",
+    "YRBS::1993::Q26: valid final_decision required",
+    "YRBS::1993::Q26: human adjudicator identity and attestation required",
+    "YRBS::1995::Q22: valid final_decision required",
+    "YRBS::1995::Q22: human adjudicator identity and attestation required",
+    "YRBS::1995::Q23: valid final_decision required",
+    "YRBS::1995::Q23: human adjudicator identity and attestation required",
+    "YRBS::1995::Q24: valid final_decision required",
+    "YRBS::1995::Q24: human adjudicator identity and attestation required",
+    "YRBS::1997::Q22: valid final_decision required",
+    "YRBS::1997::Q22: human adjudicator identity and attestation required",
+    "YRBS::1997::Q23: valid final_decision required",
+    "YRBS::1997::Q23: human adjudicator identity and attestation required",
+    "YRBS::1997::Q24: valid final_decision required",
+    "YRBS::1997::Q24: human adjudicator identity and attestation required",
+    "YRBS::1999::Q23: valid final_decision required",
+    "YRBS::1999::Q23: human adjudicator identity and attestation required",
+    "YRBS::1999::Q24: valid final_decision required",
+    "YRBS::1999::Q24: human adjudicator identity and attestation required",
+    "YRBS::1999::Q25: valid final_decision required",
+    "YRBS::1999::Q25: human adjudicator identity and attestation required",
+    "YRBS::2001::Q24: valid final_decision required",
+    "YRBS::2001::Q24: human adjudicator identity and attestation required",
+    "YRBS::2001::Q25: valid final_decision required",
+    "YRBS::2001::Q25: human adjudicator identity and attestation required",
+    "YRBS::2001::Q26: valid final_decision required",
+    "YRBS::2001::Q26: human adjudicator identity and attestation required",
+    "YRBS::2003::Q24: valid final_decision required",
+    "YRBS::2003::Q24: human adjudicator identity and attestation required",
+    "YRBS::2003::Q25: valid final_decision required",
+    "YRBS::2003::Q25: human adjudicator identity and attestation required",
+    "YRBS::2003::Q26: valid final_decision required",
+    "YRBS::2003::Q26: human adjudicator identity and attestation required",
+    "YRBS::2005::Q24: valid final_decision required",
+    "YRBS::2005::Q24: human adjudicator identity and attestation required",
+    "YRBS::2005::Q25: valid final_decision required",
+    "YRBS::2005::Q25: human adjudicator identity and attestation required",
+    "YRBS::2005::Q26: valid final_decision required",
+    "YRBS::2005::Q26: human adjudicator identity and attestation required",
+    "YRBS::2007::Q24: valid final_decision required",
+    "YRBS::2007::Q24: human adjudicator identity and attestation required",
+    "YRBS::2007::Q25: valid final_decision required",
+    "YRBS::2007::Q25: human adjudicator identity and attestation required",
+    "YRBS::2007::Q26: valid final_decision required",
+    "YRBS::2007::Q26: human adjudicator identity and attestation required",
+    "YRBS::2009::Q24: valid final_decision required",
+    "YRBS::2009::Q24: human adjudicator identity and attestation required",
+    "YRBS::2009::Q25: valid final_decision required",
+    "YRBS::2009::Q25: human adjudicator identity and attestation required",
+    "YRBS::2009::Q26: valid final_decision required",
+    "YRBS::2009::Q26: human adjudicator identity and attestation required",
+    "YRBS::2011::Q25: valid final_decision required",
+    "YRBS::2011::Q25: human adjudicator identity and attestation required",
+    "YRBS::2011::Q26: valid final_decision required",
+    "YRBS::2011::Q26: human adjudicator identity and attestation required",
+    "YRBS::2011::Q27: valid final_decision required",
+    "YRBS::2011::Q27: human adjudicator identity and attestation required",
+    "YRBS::2013::Q27: valid final_decision required",
+    "YRBS::2013::Q27: human adjudicator identity and attestation required",
+    "YRBS::2013::Q28: valid final_decision required",
+    "YRBS::2013::Q28: human adjudicator identity and attestation required",
+    "YRBS::2013::Q29: valid final_decision required",
+    "YRBS::2013::Q29: human adjudicator identity and attestation required",
+    "YRBS::2015::Q27: valid final_decision required",
+    "YRBS::2015::Q27: human adjudicator identity and attestation required",
+    "YRBS::2015::Q28: valid final_decision required",
+    "YRBS::2015::Q28: human adjudicator identity and attestation required",
+    "YRBS::2015::Q29: valid final_decision required",
+    "YRBS::2015::Q29: human adjudicator identity and attestation required",
+    "YRBS::2017::Q26: valid final_decision required",
+    "YRBS::2017::Q26: human adjudicator identity and attestation required",
+    "YRBS::2017::Q27: valid final_decision required",
+    "YRBS::2017::Q27: human adjudicator identity and attestation required",
+    "YRBS::2017::Q28: valid final_decision required",
+    "YRBS::2017::Q28: human adjudicator identity and attestation required",
+    "YRBS::2019::Q26: valid final_decision required",
+    "YRBS::2019::Q26: human adjudicator identity and attestation required",
+    "YRBS::2019::Q27: valid final_decision required",
+    "YRBS::2019::Q27: human adjudicator identity and attestation required",
+    "YRBS::2019::Q28: valid final_decision required",
+    "YRBS::2019::Q28: human adjudicator identity and attestation required",
+    "YRBS::2021::Q26: valid final_decision required",
+    "YRBS::2021::Q26: human adjudicator identity and attestation required",
+    "YRBS::2021::Q27: valid final_decision required",
+    "YRBS::2021::Q27: human adjudicator identity and attestation required",
+    "YRBS::2021::Q28: valid final_decision required",
+    "YRBS::2021::Q28: human adjudicator identity and attestation required",
+    "YRBS::2023::Q27: valid final_decision required",
+    "YRBS::2023::Q27: human adjudicator identity and attestation required",
+    "YRBS::2023::Q28: valid final_decision required",
+    "YRBS::2023::Q28: human adjudicator identity and attestation required",
+    "YRBS::2023::Q29: valid final_decision required",
+    "YRBS::2023::Q29: human adjudicator identity and attestation required"
+  ],
+  "gate_1_human_review_complete": false
+}

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,
-        "stratum": 188898,
-        "psu": 188898
+        "weight": 217340,
+        "stratum": 217340,
+        "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.",
-    "GSHS design fields are candidates and require survey-specific source verification.",
-    "NSDUH year-specific weight selection and variance usage require confirmation against the combined-file guide.",
+    "YRBS 2021 and 2023 have validated annual full Parquet files but are not appended to the legacy 1991-2019 selected table.",
+    "One YRBS 1997 record lacks weight, stratum, and PSU; 2017/2019 design fields were restored from official fixed-width locations.",
+    "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_ENGLISH.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_ENGLISH.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_ENGLISH.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,,,needs_source,"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,,,needs_source,"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,,,needs_source,"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 - English.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 - English.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 - English.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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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?",7276c7765534b68690a1ba14199a28064b7be26f0463f4e26336b2b99a612841,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,"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?",5a5ea936e3209b50b0f6f6b0d502f3c2c791b096870a05231f554b2b96f978da,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. A codebook editorial note about the 2022 section move was removed from question_text and is retained here verbatim: 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."
+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,"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?",5a5ea936e3209b50b0f6f6b0d502f3c2c791b096870a05231f554b2b96f978da,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. A codebook editorial note about the 2022 section move was removed from question_text and is retained here verbatim: 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."
+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,"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?",5a5ea936e3209b50b0f6f6b0d502f3c2c791b096870a05231f554b2b96f978da,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. A codebook editorial note about the 2022 section move was removed from question_text and is retained here verbatim: 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."
+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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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, per the local MRB specification. Codes 85/94/97/98/99 are inherited from YUSUITHK and unattested for this variable. 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,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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, per the local MRB specification. Codes 85/94/97/98/99 are inherited from YUSUITHK and unattested for this variable. 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,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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, per the local MRB specification. Codes 85/94/97/98/99 are inherited from YUSUITHK and unattested for this variable. 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,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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, per the local MRB specification. Codes 85/94/97/98/99 are inherited from YUSUITHK and unattested for this variable. 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/populate_adjudication_table.py

@@ -0,0 +1,102 @@
+"""Fill the machine-derivable columns of the primary-outcome adjudication table.
+
+reviewer_1_decision, reviewer_2_decision and conflict_reason are facts derived
+from the two signed review packets, so they are filled here. Every adjudicator
+field (identity, date, final_*, notes, attestation) is human attestation and is
+left exactly as found -- this script never writes one and never overwrites a
+non-empty value in one.
+
+Unlike build_human_review_packets.py, this script does not write the reviewer
+packets. Those carry signatures and must not be regenerated.
+"""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+from pathlib import Path
+
+STAGE1 = Path(__file__).resolve().parent
+REVIEWER_1 = STAGE1 / "primary_outcome_review_reviewer_1.csv"
+REVIEWER_2 = STAGE1 / "primary_outcome_review_reviewer_2.csv"
+ADJUDICATION = STAGE1 / "primary_outcome_review_adjudication.csv"
+
+DERIVED = {"reviewer_1_decision", "reviewer_2_decision", "conflict_reason"}
+# Mirrors validate_human_reviews.py: an item needs adjudication when the two
+# decisions differ, or when reviewer_1 did not return a plain approve.
+APPROVE = "approve"
+
+
+def read(path: Path) -> list[dict[str, str]]:
+    with path.open(encoding="utf-8-sig", newline="") as handle:
+        return list(csv.DictReader(handle))
+
+
+def sha256(path: Path) -> str:
+    return hashlib.sha256(path.read_bytes()).hexdigest()
+
+
+def conflict_reason(d1: str, d2: str) -> str:
+    if d1 != d2:
+        return (
+            f"decisions differ: reviewer_1={d1}, reviewer_2={d2}; "
+            "adjudication required because the two decisions are not identical"
+        )
+    return (
+        f"both reviewers returned {d1}; adjudication required because "
+        "reviewer_1's decision is not a plain approve"
+    )
+
+
+def main() -> int:
+    before = {p: sha256(p) for p in (REVIEWER_1, REVIEWER_2)}
+    r1 = {r["item_version_id"]: r for r in read(REVIEWER_1)}
+    r2 = {r["item_version_id"]: r for r in read(REVIEWER_2)}
+    rows = read(ADJUDICATION)
+    fields = list(rows[0])
+
+    if set(r1) != set(r2) or set(r1) != {r["item_version_id"] for r in rows}:
+        raise SystemExit("item_version_id sets differ across the three files")
+
+    protected_written = []
+    filled = 0
+    for row in rows:
+        item = row["item_version_id"]
+        d1, d2 = r1[item]["decision"], r2[item]["decision"]
+        needs = d1 != d2 or d1 != APPROVE
+        new = {
+            "reviewer_1_decision": d1,
+            "reviewer_2_decision": d2,
+            "conflict_reason": conflict_reason(d1, d2) if needs else "",
+        }
+        for key, value in new.items():
+            if row[key] != value:
+                row[key] = value
+                filled += 1
+        for key in fields:
+            if key not in DERIVED and key != "item_version_id" and row[key].strip():
+                protected_written.append(f"{item}:{key}")
+
+    with ADJUDICATION.open("w", encoding="utf-8-sig", newline="") as handle:
+        writer = csv.DictWriter(handle, fieldnames=fields)
+        writer.writeheader()
+        writer.writerows(rows)
+
+    after = {p: sha256(p) for p in (REVIEWER_1, REVIEWER_2)}
+    if before != after:
+        raise SystemExit("FATAL: a signed reviewer packet changed; investigate before committing")
+
+    summary = {
+        "rows": len(rows),
+        "derived_cells_written": filled,
+        "items_requiring_adjudication": sum(1 for r in rows if r["conflict_reason"]),
+        "existing_adjudicator_values_preserved": len(protected_written),
+        "signed_packets_unchanged": True,
+    }
+    print(json.dumps(summary, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

research/stage1/primary_outcome_ai_precheck_summary.md

@@ -0,0 +1,112 @@
+# Primary-outcome AI pre-check — reference only
+
+**Status: NOT a human review.** `human_review_instructions.md` requires two different actual people and
+explicitly excludes AI output. This file and `primary_outcome_review_ai_reviewer.csv` are a *reference
+pre-check*: a second pair of eyes on the evidence, produced by Claude (claude-opus-5) on 2026-09-20, for a
+human reviewer to check against and disagree with. Neither file may be submitted as reviewer 1 or
+reviewer 2, and `primary_outcome_review_ai_reviewer.csv` is deliberately built to fail
+`validate_human_reviews.py` (its `independence_attestation` is a non-human statement).
+
+`primary_outcome_review_reviewer_1.csv` was not opened at any point.
+
+## Totals
+
+| | approve | approve_with_correction | needs_source |
+|---|---:|---:|---:|
+| YRBS (51) | 45 | 6 | 0 |
+| GSHS (21) | 0 | 18 | 3 |
+| NSDUH (12) | 0 | 8 | 4 |
+| **All 84** | **45** | **32** | **7** |
+
+Language evidence: 69 `provisional_accepted`, 15 `insufficient`. No rejections — no registered item looks
+like the wrong item.
+
+## What was checked, and against what
+
+Everything below came from files already in this repository; nothing was taken from the registry's own
+summaries, and no remote source was fetched.
+
+- **YRBS (51 rows, 17 years).** Wording read from each annual national HS questionnaire PDF; variable
+  names cross-checked against each annual Data User's Guide codebook; response codes and the "Data Edits"
+  missing rule read from the guides; target population read from the guides.
+- **GSHS (21 rows, 7 components).** Wording read from each country questionnaire at the cited item number;
+  response codes verified against the country codebooks *and* recomputed from `GSHS.csv`; population,
+  design and participant counts read from each WHO country fact sheet.
+- **NSDUH (12 rows, 4 years).** Wording, routing and response options read from the local MRB
+  specifications in `Dataset/NSDUH/`; codes and value labels from the local dictionary and value-label
+  tables.
+
+## Findings that change something
+
+**1. The NSDUH attempt rows rest on documents nobody opened.** All four `YUSUICTRY` rows have a blank
+`source_file` and cite remote SAMHSA PDFs. The project's own audit says those endpoints returned HTTP 403
+and that "visual page-level PDF verification is not claimed". Meanwhile the item is fully documented in a
+file already in the repo that the registry does not cite — `Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf`
+(and the 2022–2024 equivalents) carries `YSUI03 [IF CURNTAGE = 12 – 17] During the past 12 months, did you
+try to kill yourself?` with its four response options. Re-citing closes the wording, population and
+skip-logic gaps at once. What does *not* close: `YUSUICTRY` appears in no local dictionary, value-label
+table or Parquet schema, yet the response dictionary asserts nine codes for it including the PUF
+conventions 85/94/97/98/99. Those are unattested for this variable and look carried over from `YUSUITHK`.
+
+**2. A codebook change-note is sitting in the question text.** NSDUH ideation for 2022, 2023 and 2024
+stores "Note: Beginning in 2022, questions YSUI01 … were moved from the youth mental health service
+utilization section to the youth experiences section" as part of `question_text`. That was never read to a
+respondent, and it feeds any wording comparison or text-similarity linking. The 2021 row has the opposite
+defect: it omits the sentence "You can answer 'I'm not sure' or 'I don't want to answer' to any question",
+which the 2021 specification shows *was* in the instrument. Store stem and lead-in as separate fields.
+
+**3. The NSDUH language gap is already solved in the local data.** The registry records administered
+language as "not established". The MRB specification opens with `LANG` ("Would you like to complete this
+interview in English or Spanish?"), and `LANGVER` (1=English, 2=Spanish) is present in the local
+dictionary and data for all four years. Language is recoverable per respondent; until it is carried, these
+items cannot be labelled English.
+
+**4. Six GSHS rows cite the French questionnaire but store the English text.** Morocco (Fez) and Wallis and
+Futuna both ship English *and* French instruments; the registry cites the French file for English wording.
+The item numbers match in both languages, so this is a mis-citation rather than wrong wording — but the
+cited evidence does not contain the stored text, so `wording_verified` is "no" on those rows. Related:
+the French instruments render the plan item as "as-tu réfléchi à la manière de te suicider" (*did you think
+about how*), weaker than "make a plan", and leave "2 or 3 fois" / "4 or 5 fois" partly untranslated. That
+belongs in any measurement-invariance discussion.
+
+**5. GSHS population is left provisional when the answer is in the same folder.** Eighteen rows carry
+"exact sampled ages/grades remain pending component source review" while the WHO fact sheet beside the
+cited questionnaire states the grade range, the design and the participant count. Corrected population text
+is supplied per component in the CSV. Two of those components — **Jamaica (St Catherine) and Wallis and
+Futuna — were censuses, not two-stage cluster samples**, yet `survey_design.csv` gives them the same
+weight/stratum/PSU Taylor-linearization treatment as the sampled components and marks them
+`source_verified_fields`. That needs an explicit decision before pooling.
+
+**6. Solomon Islands has no instrument anywhere.** A recursive search for "solomon" and "SLB" under
+`Dataset/` returns nothing: no questionnaire, no codebook, no fact sheet, unlike the other six components.
+The wording is inherited from the GSHS core instrument rather than read from the Solomon Islands form, and
+`page_or_section` points at another internal artefact instead of an official page. Also, the "13–17 years"
+population claim is the fact-sheet *reporting* range; the recorded age range spans 11-or-younger to
+18-or-older for all seven components.
+
+**7. YRBS 1995 and 1997 were not fully national.** Both user guides state the frame excluded a majority of
+Louisiana. The registry population string omits this and so overstates national coverage for those years.
+Separately, one 1997 record lacks weight, stratum and PSU and needs a documented exclusion rule.
+
+**8. The NSDUH missing rule deviates from the source, silently.** The source classifies code 4 "I don't
+want to answer" as a valid, non-missing response; the project reclassifies it as `refused` /
+not-observed while keeping code 3 "I'm not sure" as observed. Defensible, but undocumented — and the
+ontology's own rule about retaining explicit uncertainty arguably covers code 4 too.
+
+## What held up
+
+The YRBS block is in good shape. All 51 rows matched their questionnaires verbatim, and the
+variable-number mapping — which looks wrong at a glance, because the dataset variable number differs from
+the printed item number in most years (2023: printed item 31, variable Q27) — is correct in every year,
+confirmed against each annual guide rather than assumed. The `source_conflicts.csv` mapping corrections
+reproduce independently. GSHS response codes verified twice over: Ghana's country codebook reproduces cell
+for cell against `GSHS.csv` (ideation 901 Yes / 2744 No / 151 missing), and every component's row count
+matches its fact-sheet participant count, so no respondents go missing before the outcome items.
+
+## Suggested order of work for the human reviewer
+
+1. The 7 `needs_source` rows — these are the ones that cannot be signed as-is.
+2. The 4 NSDUH ideation rows — decide where the change-note text should live.
+3. The 18 GSHS `approve_with_correction` rows — mostly accept-or-amend the supplied population text.
+4. The 6 YRBS 1995/1997 rows.
+5. The 45 YRBS `approve` rows — spot-check a few years rather than all seventeen.

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_ENGLISH.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_ENGLISH.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_ENGLISH.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 - English.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 - English.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 - English.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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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 fifty states and the District of Columbia, excluding a majority of Louisiana; 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,"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,"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,"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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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: 34
+- 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

@@ -0,0 +1,35 @@
+# Primary outcome source registry
+
+Version: 1.4 | Status: provisional | Generated: 2026-09-20
+
+## Scope and decision boundary
+
+This registry captures source-linked candidates for suicide ideation, plan, and attempt. It is a development artifact, not an approved item bank. No row has completed the two-human-reviewer requirement, no cross-survey link is approved, and no missing or skip code has been canonically recoded.
+
+## Candidate coverage
+
+| Survey | Ideation | Plan | Attempt | Current evidence boundary |
+|---|---:|---:|---:|---|
+| 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 directly cross-checked; 21 prior mappings corrected; 2021/2023 data remain quarantined. |
+| 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 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.
+- 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.
+- 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 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
+
+Run `research/stage1/build_primary_outcome_registry.py` in the locked research environment. The script reads repository-local dictionaries and Parquet schemas and rewrites this report plus `primary_outcome_registry.json`.

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,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::2023_MAR_GSHS_v01::mar_fez2023::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_considersui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::GHA_2022_GSHS_v01::gha_sek_tak2022::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_considersui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::IND_2022_GSHS_v01::ind_jaipur_2022::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_considersui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::JAM_2023_GSHS_v01::jam_st_cath_2023::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_considersui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::MNG_2023_GSHS_v01::mng2023::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_considersui,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_plansui,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+GSHS::SLB_2023_GSHS_v01::slb_2023::raw_mh_attemptsui,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_considersui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_plansui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+GSHS::WLF_2023_GSHS_v01::wlf_2023::raw_mh_attemptsui,needs_source,approve_with_correction,"decisions differ: reviewer_1=needs_source, reviewer_2=approve_with_correction; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1991::Q19,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1991::Q20,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1991::Q21,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1993::Q24,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1993::Q25,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1993::Q26,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1995::Q22,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1995::Q23,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1995::Q24,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1997::Q22,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1997::Q23,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1997::Q24,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+YRBS::1999::Q23,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1999::Q24,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::1999::Q25,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2001::Q24,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2001::Q25,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2001::Q26,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2003::Q24,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2003::Q25,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2003::Q26,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2005::Q24,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2005::Q25,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2005::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2007::Q24,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2007::Q25,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2007::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2009::Q24,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2009::Q25,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2009::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2011::Q25,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2011::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2011::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2013::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2013::Q28,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2013::Q29,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2015::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2015::Q28,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2015::Q29,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2017::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2017::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2017::Q28,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2019::Q26,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2019::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2019::Q28,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2021::Q26,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2021::Q27,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2021::Q28,approve_with_correction,approve,"decisions differ: reviewer_1=approve_with_correction, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2023::Q27,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2023::Q28,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+YRBS::2023::Q29,needs_source,approve,"decisions differ: reviewer_1=needs_source, reviewer_2=approve; adjudication required because the two decisions are not identical",,,,,,,,,,
+NSDUH::2021::YUSUITHK,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2021::YUSUIPLN,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2022::YUSUITHK,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2022::YUSUIPLN,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2023::YUSUITHK,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2023::YUSUIPLN,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2024::YUSUITHK,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2024::YUSUIPLN,approve_with_correction,approve_with_correction,both reviewers returned approve_with_correction; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2021::YUSUICTRY,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2022::YUSUICTRY,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2023::YUSUICTRY,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,
+NSDUH::2024::YUSUICTRY,needs_source,needs_source,both reviewers returned needs_source; adjudication required because reviewer_1's decision is not a plain approve,,,,,,,,,,

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,Jino Gu,Project Reviewer,2026/9/20,needs_source,no,yes,no,no,yes,yes,insufficient,"Au cours des 12 derniers mois, as-tu sérieusement envisagé d’essayer de te suicider ?",,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_ENGLISH.pdf，Q32，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。 问卷文件/页眉为Fez 2022，而组件/代码本为2023；需说明该问卷与2023施测版本的对应关系。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/21,needs_source,no,yes,no,no,yes,yes,insufficient,Au cours des 12 derniers mois as-tu réfléchi à la manière de te suicider ?,,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_ENGLISH.pdf，Q33，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。 法语“réfléchi à la manière”偏向思考方式，英语“make a plan”明确制订计划；构念可暂列计划，但跨语言严格等价须由具备语言能力的真人进一步评估。 问卷文件/页眉为Fez 2022，而组件/代码本为2023；需说明该问卷与2023施测版本的对应关系。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/22,needs_source,no,yes,no,no,yes,yes,insufficient,"Au cours des 12 derniers mois, combien de fois as-tu essayé de te suicider ?",,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Morocco 2023/Fez_2022_GSHS_Questionnaire_Final_ENGLISH.pdf，Q34，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。 问卷文件/页眉为Fez 2022，而组件/代码本为2023；需说明该问卷与2023施测版本的对应关系。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/23,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf，Q33，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/24,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf，Q34，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/25,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Ghana 2022/Sekondi-Takoradi-2022_GSHS_Questionnaire-Final.pdf，Q35，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/26,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx，Q34，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/27,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx，Q35，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/28,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/India 2022/Jaipur-2022_GSHS_Questionnaire-Final.docx，Q36，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/29,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx，Q28，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/9/30,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx，Q29，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/1,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Jamaica 2023/FINAL_St. Catherine-2023-GSHS-Questionnaire.docx，Q30，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/2,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx，Q36，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 本轮以英语参考问卷核验；未完成蒙古语题文的语言专家核验。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/3,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx，Q37，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 本轮以英语参考问卷核验；未完成蒙古语题文的语言专家核验。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/4,needs_source,yes,yes,no,no,yes,yes,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Mongolia 2023/Mongolia-GSHS-Questionnaire-ENGLISH.docx，Q38，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 本轮以英语参考问卷核验；未完成蒙古语题文的语言专家核验。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/5,needs_source,no,yes,yes,no,no,no,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",本轮直接读取WHO catalog 992研究页，确认13-17岁在校总体、Form 1-6及入选班级全员有资格。V39/V40/V41逐题URL本轮读取失败，旧审计虽声称核实题文与编码，本轮不将其复制为独立核实。需重取逐题来源和国家问卷以核对跳题。构念yes仅针对现有题干的语义分类。 来源：https://extranet.who.int/ncdsmicrodata/index.php/catalog/992；逐题来源为同目录variable/V39、V40、V41。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/6,needs_source,no,yes,yes,no,no,no,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",本轮直接读取WHO catalog 992研究页，确认13-17岁在校总体、Form 1-6及入选班级全员有资格。V39/V40/V41逐题URL本轮读取失败，旧审计虽声称核实题文与编码，本轮不将其复制为独立核实。需重取逐题来源和国家问卷以核对跳题。构念yes仅针对现有题干的语义分类。 来源：https://extranet.who.int/ncdsmicrodata/index.php/catalog/992；逐题来源为同目录variable/V39、V40、V41。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/7,needs_source,no,yes,yes,no,no,no,insufficient,,,,,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",本轮直接读取WHO catalog 992研究页，确认13-17岁在校总体、Form 1-6及入选班级全员有资格。V39/V40/V41逐题URL本轮读取失败，旧审计虽声称核实题文与编码，本轮不将其复制为独立核实。需重取逐题来源和国家问卷以核对跳题。构念yes仅针对现有题干的语义分类。 来源：https://extranet.who.int/ncdsmicrodata/index.php/catalog/992；逐题来源为同目录variable/V39、V40、V41。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/8,needs_source,no,yes,no,no,yes,yes,insufficient,"Au cours des 12 derniers mois, as-tu sérieusement envisagé d’essayer de te suicider ?",,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - English.docx，Q29，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/9,needs_source,no,yes,no,no,yes,yes,insufficient,Au cours des 12 derniers mois as-tu réfléchi à la manière de te suicider ?,,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - English.docx，Q30，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。 法语“réfléchi à la manière”偏向思考方式，英语“make a plan”明确制订计划；构念可暂列计划，但跨语言严格等价须由具备语言能力的真人进一步评估。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/10,needs_source,no,yes,no,no,yes,yes,insufficient,"Au cours des 12 derniers mois, combien de fois as-tu essayé de te suicider ?",,,French source questionnaire plus separate English reference; actual administered language unverified.,"Preserve blank/null/system missing as unknown; do not turn nonresponse into No or zero. Verify numeric released-value labels against the component codebook/data labels, separately from lettered questionnaire choices. Do not count MH_B derived indicators as independent administered items.",直接核对Dataset/GSHS-全球学生健康调查数据/GSHS/Questionnaire/GSHS Per Country/Wallis and Futuna 2023/Wallis and Futuna - GSHS Questionnaire - Final - English.docx，Q31，并对照本组件raw codebook的MH_CONSIDERSUI/MH_PLANSUI/MH_ATTEMPTSUI。过去12个月窗口、构念、A/B或A-E选项顺序一致；三题间未见阳性筛选路由。 仍需：组件采样年龄/年级与纳入条件、实际施测语言、字母选项到发布数值编码的直接映射。年龄题的可选范围不等于样本纳入范围。缺失yes仅指保留unknown，不声称已识别缺失原因。 当前source_file指向法语问卷，question_text却是英语参考题干；corrected_question_text给出引用文件中的法语正文，英语应单独保留为reference text，不能当作实际施测语言证据。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/11,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1991_hs_questionnaire.pdf PDF页[5] 印刷Q19，以及 YRBS_1991_National_User_Guide.pdf page 9，发布变量为Q19。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/12,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1991_hs_questionnaire.pdf PDF页[5] 印刷Q20，以及 YRBS_1991_National_User_Guide.pdf page 9，发布变量为Q20。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/13,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1991_hs_questionnaire.pdf PDF页[5] 印刷Q21，以及 YRBS_1991_National_User_Guide.pdf page 9，发布变量为Q21。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/14,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1993_xxh_questionnaire.pdf PDF页[6] 印刷Q23，以及 YRBS_1993_National_User_Guide.pdf page 11，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/15,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1993_xxh_questionnaire.pdf PDF页[6] 印刷Q24，以及 YRBS_1993_National_User_Guide.pdf page 11，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/16,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1993_xxh_questionnaire.pdf PDF页[6] 印刷Q25，以及 YRBS_1993_National_User_Guide.pdf page 11，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/17,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1995_xxh_questionnaire.pdf PDF页[6] 印刷Q22，以及 YRBS_1995_National_User_Guide.pdf pages 11-12，发布变量为Q22。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/18,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1995_xxh_questionnaire.pdf PDF页[6] 印刷Q23，以及 YRBS_1995_National_User_Guide.pdf pages 11-12，发布变量为Q23。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/19,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1995_xxh_questionnaire.pdf PDF页[6] 印刷Q24，以及 YRBS_1995_National_User_Guide.pdf pages 11-12，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/20,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1997_xxh_questionnaire.pdf PDF页[6] 印刷Q21，以及 YRBS_1997_National_User_Guide.pdf pages 11-12，发布变量为Q22。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/21,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1997_xxh_questionnaire.pdf PDF页[6] 印刷Q22，以及 YRBS_1997_National_User_Guide.pdf pages 11-12，发布变量为Q23。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/22,approve_with_correction,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 in public, Catholic, and other private schools in the fifty states and the District of Columbia, excluding a majority of Louisiana, as stated in the annual guide Methodology (PDF p.3).",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1997_xxh_questionnaire.pdf PDF页[6] 印刷Q23，以及 YRBS_1997_National_User_Guide.pdf pages 11-12，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 实质修订：年度指南PDF第3页明确排除Louisiana的大部分地区，原总体字段遗漏此限制。population_verified=no指原字段尚不完整；建议按corrected_population修订。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/23,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1999_xxh_questionnaire.pdf PDF页[7] 印刷Q23，以及 YRBS_1999_National_User_Guide.pdf page 7，发布变量为Q23。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/24,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1999_xxh_questionnaire.pdf PDF页[7] 印刷Q24，以及 YRBS_1999_National_User_Guide.pdf page 7，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/25,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 1999_xxh_questionnaire.pdf PDF页[7] 印刷Q25，以及 YRBS_1999_National_User_Guide.pdf page 7，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/26,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2001_xxh_questionnaire.pdf PDF页[7] 印刷Q25，以及 YRBS_2001_National_User_Guide.pdf pages 8-9，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/27,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2001_xxh_questionnaire.pdf PDF页[7] 印刷Q26，以及 YRBS_2001_National_User_Guide.pdf pages 8-9，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/28,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2001_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2001_National_User_Guide.pdf pages 8-9，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/29,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2003_xxh_questionnaire.pdf PDF页[7] 印刷Q25，以及 YRBS_2003_National_User_Guide.pdf pages 9-10，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/30,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2003_xxh_questionnaire.pdf PDF页[7] 印刷Q26，以及 YRBS_2003_National_User_Guide.pdf pages 9-10，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/10/31,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2003_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2003_National_User_Guide.pdf pages 9-10，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签已在年度代码本核对。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/1,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2005_xxh_questionnaire.pdf PDF页[7] 印刷Q26，以及 YRBS_2005_National_User_Guide.pdf pages 16-17，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/2,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2005_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2005_National_User_Guide.pdf pages 16-17，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/3,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2005_xxh_questionnaire.pdf PDF页[7] 印刷Q28，以及 YRBS_2005_National_User_Guide.pdf pages 16-17，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/4,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2007_xxh_questionnaire.pdf PDF页[7] 印刷Q25，以及 YRBS_2007_National_User_Guide.pdf page 20，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/5,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2007_xxh_questionnaire.pdf PDF页[7] 印刷Q26，以及 YRBS_2007_National_User_Guide.pdf page 20，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/6,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2007_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2007_National_User_Guide.pdf page 20，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/7,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2009_xxh_questionnaire.pdf PDF页[7] 印刷Q25，以及 YRBS_2009_National_User_Guide.pdf page 22，发布变量为Q24。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/8,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2009_xxh_questionnaire.pdf PDF页[7] 印刷Q26，以及 YRBS_2009_National_User_Guide.pdf page 22，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/9,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2009_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2009_National_User_Guide.pdf page 22，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/10,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2011_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 YRBS_2011_National_User_Guide.pdf page 20，发布变量为Q25。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/11,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2011_xxh_questionnaire.pdf PDF页[7] 印刷Q28，以及 YRBS_2011_National_User_Guide.pdf page 20，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/12,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2011_xxh_questionnaire.pdf PDF页[8] 印刷Q29，以及 YRBS_2011_National_User_Guide.pdf page 20，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/13,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2013_xxh_questionnaire.pdf PDF页[8] 印刷Q27，以及 YRBS_2013_National_User_Guide.pdf page 28，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/14,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2013_xxh_questionnaire.pdf PDF页[8] 印刷Q28，以及 YRBS_2013_National_User_Guide.pdf page 28，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/15,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2013_xxh_questionnaire.pdf PDF页[8] 印刷Q29，以及 YRBS_2013_National_User_Guide.pdf page 28，发布变量为Q29。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/16,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2015_xxh_questionnaire.pdf PDF页[7] 印刷Q27，以及 2015_yrbs-data-users_guide_smy_combined.pdf page 29，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/17,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2015_xxh_questionnaire.pdf PDF页[7] 印刷Q28，以及 2015_yrbs-data-users_guide_smy_combined.pdf page 29，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/18,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2015_xxh_questionnaire.pdf PDF页[8] 印刷Q29，以及 2015_yrbs-data-users_guide_smy_combined.pdf page 29，发布变量为Q29。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。 指南PDF第29页QN29分子/分母文字出现F，但该题只列A-E五项；不要新增第六个观测类别，需记录官方文档内部不一致。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/19,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2017_yrbs_national_hs_questionnaire.pdf PDF页[8] 印刷Q27，以及 2017_YRBS_Data_Users_Guide.pdf page 29，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/20,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2017_yrbs_national_hs_questionnaire.pdf PDF页[8] 印刷Q28，以及 2017_YRBS_Data_Users_Guide.pdf page 29，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/21,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2017_yrbs_national_hs_questionnaire.pdf PDF页[8] 印刷Q29，以及 2017_YRBS_Data_Users_Guide.pdf page 29，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/22,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2019_YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q26，以及 2019_National_YRBS_Data_Users_Guide.pdf pages 27-28，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/23,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2019_YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q27，以及 2019_National_YRBS_Data_Users_Guide.pdf pages 27-28，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/24,needs_source,yes,yes,yes,no,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2019_YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q28，以及 2019_National_YRBS_Data_Users_Guide.pdf pages 27-28，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 问卷及指南已核实A/B或A-E选项顺序；本轮未取得并逐项核验本年度发布文件的数字值标签/格式映射，因此未将1/2或1-5标为独立核实。需补本年度官方格式程序或原始值标签，不能仅沿用项目字典。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/25,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2021-YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q26，以及 2021_YRBS_Data_Users_Guide_508.pdf page 28，发布变量为Q26。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2021_cdc_download/2021XXH-Formats-Program.sas 的H26S格式：空白为Missing。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/26,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2021-YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q27，以及 2021_YRBS_Data_Users_Guide_508.pdf page 28，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2021_cdc_download/2021XXH-Formats-Program.sas 的H27S格式：空白为Missing。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/27,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,"Students in grades 9-12 attending public and private schools in the United States; school-based population, not all adolescents.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2021-YRBS-National-HS-Questionnaire.pdf PDF页[8] 印刷Q28，以及 2021_YRBS_Data_Users_Guide_508.pdf page 28，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2021_cdc_download/2021XXH-Formats-Program.sas 的H28S格式：空白为Missing。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/28,needs_source,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Pending reconciliation: annual guide pp.4-5 describes national grades 9-12 public/private school students, but p.6 gives 36 states, three tribal governments, five territories and 21 local school districts; do not adopt the p.6 jurisdiction list as a verified national sampling frame.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2023_YRBS_National_HS_Questionnaire.pdf PDF页[9] 印刷Q31，以及 2023_National_YRBS_Data_Users_Guide508.pdf page 29，发布变量为Q27。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2023_cdc_download/2023XXH-Formats-Program.sas 的H27S格式：空白为Missing。 来源冲突：指南PDF第6页抽样框范围与第4-5页全国总体说明不一致，已渲染核实不是抽取错误。需另查官方2023方法报告或更正。零次尝试跳过后续伤害题，不跳过本尝试题。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/29,needs_source,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Pending reconciliation: annual guide pp.4-5 describes national grades 9-12 public/private school students, but p.6 gives 36 states, three tribal governments, five territories and 21 local school districts; do not adopt the p.6 jurisdiction list as a verified national sampling frame.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2023_YRBS_National_HS_Questionnaire.pdf PDF页[9] 印刷Q32，以及 2023_National_YRBS_Data_Users_Guide508.pdf page 29，发布变量为Q28。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2023_cdc_download/2023XXH-Formats-Program.sas 的H28S格式：空白为Missing。 来源冲突：指南PDF第6页抽样框范围与第4-5页全国总体说明不一致，已渲染核实不是抽取错误。需另查官方2023方法报告或更正。零次尝试跳过后续伤害题，不跳过本尝试题。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/11/30,needs_source,yes,yes,no,yes,yes,yes,provisional_accepted,,,"Pending reconciliation: annual guide pp.4-5 describes national grades 9-12 public/private school students, but p.6 gives 36 states, three tribal governments, five territories and 21 local school districts; do not adopt the p.6 jurisdiction list as a verified national sampling frame.",English reference questionnaire verified; actual respondent language and accommodations unverified. Provisional source-text use only; no administered-language or language-DIF claim.,"Retain released blank/null/system missing as unknown missing, including potentially edit-induced missing. Do not infer refusal, legitimate skip, No, or zero from a blank. Keep the five attempt-frequency categories when applicable.",直接核对 2023_YRBS_National_HS_Questionnaire.pdf PDF页[9] 印刷Q33，以及 2023_National_YRBS_Data_Users_Guide508.pdf page 29，发布变量为Q29。印刷题号与数据变量号分别使用。 构念与过去12个月窗口相符；问卷未把本题限定于意念/计划阳性者。不得按严格阶段嵌套删除无意念的计划或尝试。 缺失规则yes仅确认保守保留unknown的处理与已读来源相容，不代表能识别每个缺失原因。language provisional_accepted仅接受英语来源文本，不证明实际施测语言。 数字值标签另核对 source_archive/2023_cdc_download/2023XXH-Formats-Program.sas 的H29S格式：空白为Missing。 来源冲突：指南PDF第6页抽样框范围与第4-5页全国总体说明不一致，已渲染核实不是抽取错误。需另查官方2023方法报告或更正。零次尝试跳过后续伤害题，不跳过本尝试题。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/1,approve_with_correction,no,yes,yes,yes,yes,yes,provisional_accepted,"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?",,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2021NSDUHmrbCAISpecs011321.pdf PDF页678-679，YSUI01条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 题干建议单独保存上述问题，将引导语、回答提示、日期填充及访谈模式另存上下文；2021 CAI与web引导语有差异。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/2,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2021NSDUHmrbCAISpecs011321.pdf PDF页678-679，YSUI02条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/3,approve_with_correction,no,yes,yes,yes,yes,yes,provisional_accepted,"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?",,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf PDF页585-587，YSUI01条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 删除题文字段开头的模块迁移Note；这是代码本编辑说明，不是向受访者施测的题文。引导语和回答提示另存上下文。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/4,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf PDF页585-587，YSUI02条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/5,approve_with_correction,no,yes,yes,yes,yes,yes,provisional_accepted,"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?",,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2023NSDUHmrbCAISpecs020223.pdf PDF页601-603，YSUI01条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 删除题文字段开头的模块迁移Note；这是代码本编辑说明，不是向受访者施测的题文。引导语和回答提示另存上下文。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/6,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2023NSDUHmrbCAISpecs020223.pdf PDF页601-603，YSUI02条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/7,approve_with_correction,no,yes,yes,yes,yes,yes,provisional_accepted,"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?",,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2024-nsduh-mrb-cai-specs.pdf PDF页597-598，YSUI01条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 删除题文字段开头的模块迁移Note；这是代码本编辑说明，不是向受访者施测的题文。引导语和回答提示另存上下文。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/8,approve_with_correction,yes,yes,yes,yes,yes,yes,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Keep 1=Yes, 2=No, 3=I am not sure (observed uncertainty, not No). Keep 4 and 97 as refusal with raw codes retained; 85=data error, 94=do not know, 98=blank, 99=legitimate skip. Never infer a negative response from missing or skip.",直接核对 Dataset/NSDUH/2024-nsduh-mrb-cai-specs.pdf PDF页597-598，YSUI02条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 1/2/3/4/85/94/97/98/99与本地官方2021代码本PDF页551-552、2022代码本PDF页479及2021-2024合并官方代码本PDF页447逐项对照；合并代码本不代替每年问卷，年度跳题另由CAI核对。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/9,needs_source,yes,yes,yes,no,yes,no,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Questionnaire verifies options 1=Yes, 2=No, 3=I am not sure, 4=I do not want to answer and DK/REF. Obtain the annual restricted-use YUSUICTRY codebook to verify numeric special codes (85/94/97/98/99); do not copy those codes from ideation/plan. Do not fabricate local attempt responses or recode absent data to No.",直接核对 Dataset/NSDUH/2021NSDUHmrbCAISpecs011321.pdf PDF页678-679，YSUI03条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 施测题干、四个选项和年龄路由已核对，但本轮未直接读取年度restricted-use代码本中的YUSUICTRY数值编码；特殊缺失码及该发布变量名与YSUI03的映射仍需原始来源确认。现有项目记录称本地公用数据不含该字段，本轮未重扫Parquet，不能以既有记录冒充新检查。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/10,needs_source,yes,yes,yes,no,yes,no,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Questionnaire verifies options 1=Yes, 2=No, 3=I am not sure, 4=I do not want to answer and DK/REF. Obtain the annual restricted-use YUSUICTRY codebook to verify numeric special codes (85/94/97/98/99); do not copy those codes from ideation/plan. Do not fabricate local attempt responses or recode absent data to No.",直接核对 Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf PDF页585-587，YSUI03条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 施测题干、四个选项和年龄路由已核对，但本轮未直接读取年度restricted-use代码本中的YUSUICTRY数值编码；特殊缺失码及该发布变量名与YSUI03的映射仍需原始来源确认。现有项目记录称本地公用数据不含该字段，本轮未重扫Parquet，不能以既有记录冒充新检查。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/11,needs_source,yes,yes,yes,no,yes,no,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Questionnaire verifies options 1=Yes, 2=No, 3=I am not sure, 4=I do not want to answer and DK/REF. Obtain the annual restricted-use YUSUICTRY codebook to verify numeric special codes (85/94/97/98/99); do not copy those codes from ideation/plan. Do not fabricate local attempt responses or recode absent data to No.",直接核对 Dataset/NSDUH/2023NSDUHmrbCAISpecs020223.pdf PDF页601-603，YSUI03条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 施测题干、四个选项和年龄路由已核对，但本轮未直接读取年度restricted-use代码本中的YUSUICTRY数值编码；特殊缺失码及该发布变量名与YSUI03的映射仍需原始来源确认。现有项目记录称本地公用数据不含该字段，本轮未重扫Parquet，不能以既有记录冒充新检查。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.
+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,Jino Gu,Project Reviewer,2026/12/12,needs_source,yes,yes,yes,no,yes,no,provisional_accepted,,,NSDUH respondents aged 12-17 (CURNTAGE=12-17) in the survey target population; YSUI01-YSUI03 are not conditional on a positive ideation response. Preserve the full survey design for domain analysis.,"English CAI specification verified; available web specification checked for 2021, 2023 and 2024. Respondent-level administered language/accommodations remain unverified; provisional source-text use only.","Questionnaire verifies options 1=Yes, 2=No, 3=I am not sure, 4=I do not want to answer and DK/REF. Obtain the annual restricted-use YUSUICTRY codebook to verify numeric special codes (85/94/97/98/99); do not copy those codes from ideation/plan. Do not fabricate local attempt responses or recode absent data to No.",直接核对 Dataset/NSDUH/2024-nsduh-mrb-cai-specs.pdf PDF页597-598，YSUI03条件为CURNTAGE=12-17；计划和尝试均不以意念阳性为条件。 施测题干、四个选项和年龄路由已核对，但本轮未直接读取年度restricted-use代码本中的YUSUICTRY数值编码；特殊缺失码及该发布变量名与YSUI03的映射仍需原始来源确认。现有项目记录称本地公用数据不含该字段，本轮未重扫Parquet，不能以既有记录冒充新检查。 language provisional_accepted只接受英语参考材料；未批准跨语言测量等价。,I am a human reviewer and completed this review independently.

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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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_ENGLISH.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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 - English.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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,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,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,needs_source
+NSDUH::2021::YUSUICTRY,94,DON'T KNOW,,dont_know,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,needs_source
+NSDUH::2021::YUSUICTRY,97,REFUSED,,refused,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,needs_source
+NSDUH::2021::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,needs_source
+NSDUH::2021::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2021NSDUHMRBWebSpecs101422.pdf,https://www.samhsa.gov/data/sites/default/files/2021-09/NSDUHRDCCodebook2021.pdf,YSUI03,needs_source
+NSDUH::2022::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,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,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,needs_source
+NSDUH::2022::YUSUICTRY,94,DON'T KNOW,,dont_know,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,needs_source
+NSDUH::2022::YUSUICTRY,97,REFUSED,,refused,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,needs_source
+NSDUH::2022::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,needs_source
+NSDUH::2022::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2022NSDUHmrbCAISpecs070722.pdf,https://www.samhsa.gov/data/sites/default/files/NSDUH-RDC/NSDUHRDCCodebook2022.pdf,YSUI03,needs_source
+NSDUH::2023::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,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,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,needs_source
+NSDUH::2023::YUSUICTRY,94,DON'T KNOW,,dont_know,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,needs_source
+NSDUH::2023::YUSUICTRY,97,REFUSED,,refused,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,needs_source
+NSDUH::2023::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,needs_source
+NSDUH::2023::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2023NSDUHmrbWebCAISpecs013123.pdf,https://www.samhsa.gov/data/system/files/media-puf-file/2023-nsduh-rdc-codebook.pdf,YSUI03,needs_source
+NSDUH::2024::YUSUICTRY,1,Yes,yes,,true,direct recode; no imputation and no silent conversion of nonresponse to a negative response,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,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,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,needs_source
+NSDUH::2024::YUSUICTRY,94,DON'T KNOW,,dont_know,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,needs_source
+NSDUH::2024::YUSUICTRY,97,REFUSED,,refused,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,needs_source
+NSDUH::2024::YUSUICTRY,98,BLANK (NO ANSWER),,ordinary_missing,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,needs_source
+NSDUH::2024::YUSUICTRY,99,LEGITIMATE SKIP,,legitimate_skip,false,code inherited from the ideation variable YUSUITHK; no local dictionary or schema attests it for this variable,Dataset/NSDUH/2024-nsduh-mrb-eng-web-specs.pdf,https://www.samhsa.gov/data/sites/default/files/reports/rpt44494/2024-nsduh-mrb-eng-web-specs.pdf,YSUI03,needs_source

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,35 @@
+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_ENGLISH.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_CENSUS_DESIGN::JAM_2023_GSHS_v01::jam_st_cath_2023,GSHS,2023,JAM_2023_GSHS_v01::jam_st_cath_2023,all_primary_outcomes,design_treatment_not_established_for_census,https://extranet.who.int/ncdsmicrodata/index.php/catalog/983,"WHO GSHS country fact sheet (census statement, 100% school response rate)","The fact sheet reports a census, but weight/PSU/stratum handling and the Taylor linearization plan are recorded identically to the two-stage cluster-sample components.",unresolved; design_status downgraded to census_variance_treatment_unresolved pending a source-based variance decision,Exclude from design-based variance estimates until resolved; descriptive use must state the census basis.,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 - 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_CENSUS_DESIGN::WLF_2023_GSHS_v01::wlf_2023,GSHS,2023,WLF_2023_GSHS_v01::wlf_2023,all_primary_outcomes,design_treatment_not_established_for_census,https://extranet.who.int/ncdsmicrodata/index.php/catalog/994,"WHO GSHS country fact sheet (census statement, 100% school response rate)","The fact sheet reports a census, but weight/PSU/stratum handling and the Taylor linearization plan are recorded identically to the two-stage cluster-sample components.",unresolved; design_status downgraded to census_variance_treatment_unresolved pending a source-based variance decision,Exclude from design-based variance estimates until resolved; descriptive use must state the census basis.,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,census_variance_treatment_unresolved,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. The WHO fact sheet for this component reports a census with a 100% school response rate. Design-based variance under a census is not the same as under the two-stage cluster samples, and no source establishes the Taylor linearization plan here; resolve before any design-based variance estimate."
+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,census_variance_treatment_unresolved,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. The WHO fact sheet for this component reports a census with a 100% school response rate. Design-based variance under a census is not the same as under the two-stage cluster samples, and no source establishes the Taylor linearization plan here; resolve before any design-based variance estimate."
+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 fifty states and the District of Columbia, excluding a majority of Louisiana",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 fifty states and the District of Columbia, excluding a majority of Louisiana",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.