build(stage1): create primary outcome review package

Progression.md

@@ -1,9 +1,9 @@
 # 项目进度档案
 
-版本：1.12
+版本：1.13
 建立日期：2026-09-20  
 当前总状态：`in_progress`  
-当前阶段：阶段 1 `in_progress`；三套调查主要结局来源均已直接核验，YRBS 21 条错误映射已纠正，GSHS 7 个组件均有直接条目来源；缺失规则和双人审核尚未完成
+当前阶段：阶段 1 `in_progress`；84 个主要结局题目实例、396 条回答编码、28 条设计登记和 84 条人工双审队列已形成；`responses_long.parquet`、YRBS 2021/2023 导入、设计复核和实际双人审核尚未完成
 
 ## 1. 管理规则
 
@@ -28,7 +28,7 @@
 | 阶段 | 名称 | 状态 | 当前判定 |
 |---|---|---|---|
 | 0 | 冻结研究问题、范围与版本 | `passed` | 四项交付物齐备，Gate 0 已通过；研究工具链补强与锁定完成 |
-| 1 | 有来源证据的题库和回答层 | `in_progress` | 数据契约、入口审计及三套调查主要结局直接来源核验已完成；YRBS 错误列映射已纠正；缺失规则、2021/2023 导入和人工双重审核尚未完成 |
+| 1 | 有来源证据的题库和回答层 | `in_progress` | 主要结局题库、回答字典、构念本体、候选连接、设计登记、冲突表和人工双审队列已生成；回答长表、2021/2023 导入、设计复核和实际双重审核尚未完成 |
 | 2 | 可行性、可识别性和连接审计 | `not_started` | 等待 Gate 1 |
 | 3 | 冻结验证协议与已知真值模拟 | `not_started` | 等待 Gate 2 |
 | 4 | 直接协调和传统基线 | `not_started` | 等待 Gate 3 |
@@ -81,7 +81,7 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 | 优先级 | 问题 | 影响 | 下一处理 |
 |---|---|---|---|
-| P0 | 官方题目文本、回答标签、适用总体和跳题规则尚未逐项核验 | Gate 1 与确认性分析不能通过 | 来源登记骨架已建立；下一步直接复核官方问卷/代码本，并保持 provisional 直到双人审核完成 |
+| P0 | 84 个主要结局实例尚未由两名实际审核者逐项签署，部分总体、实际施测语言和跳题细节仍为 provisional | Gate 1 与确认性分析不能通过 | 使用已导出的双审队列独立复核；AI 生成内容不得填入审核者栏 |
 | P0 | 题目共现、锚定图与可识别性尚未重算 | 不能确定 IRT/层级模型是否成立 | 完成阶段 1 后进入阶段 2 审计 |
 | P1 | 数据来源许可及可分发范围尚未逐来源完成最终复核 | 影响复现包与衍生数据交付 | 已在清单中显式标为 review required；阶段 1 按实际纳入来源逐项确认，不默认允许再分发 |
 | P1 | R、PyMC/ArviZ、心理测量包与 CUDA Toolkit 曾缺失 | 已解决：项目 Python/R 环境和 CUDA 端到端验收通过 | 后续仅按锁定文件维护；任何升级必须重跑三套烟雾测试 |
@@ -747,6 +747,21 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 - 推送状态：`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-024`、`ERR-20260920-025`；后者由 fail-closed 检查在生成文件前中止，修正后重建通过。
+- 质量边界：本行动没有生成 `responses_long.parquet`，没有解除 YRBS 2021/2023 隔离，没有解决 NSDUH 尝试题的数据访问，也没有将 AI 检查登记为人工审核。Gate 1 保持 `in_progress`。
+- 推送状态：`push_pending`；完成差异检查、提交和远端推送后更新。
+- 下一步：按官方 SAS 程序与布局验证并导入 YRBS 2021/2023；随后从已通过来源和编码检查的可用年度生成 `responses_long.parquet`，并安排两名实际审核者处理队列。
+
 ## 9. 剩余工作量估算（2026-09-20 基线）
 
 | 阶段 | 主要工作 | 预计人周 | 主要波动来源 |
@@ -769,6 +784,6 @@ Gate 0 当前判定：`passed`。四项交付物齐备；目标总体政策、
 
 阶段 1 下一行动：
 
-1. 形成三套调查主要结局的回答编码/缺失规则草案，并把需要两名实际审核者处理的记录导出为审核队列；
-2. 按官方 SAS 布局验证 YRBS 2021/2023 导入，在验证前继续隔离；
-3. 人工审核前保持全部主要结局为 `provisional`，不把 AI 预审写成双人审核。
+1. 按官方 SAS 程序和机器可读布局验证 YRBS 2021/2023 导入，核对行数、值域、题号映射和设计字段；验证前继续隔离；
+2. 以题库和回答字典为唯一映射源，为当前可用且通过检查的数据生成 `responses_long.parquet`，显式保存 eligibility 与 observed status；
+3. 安排两名实际审核者逐项处理 `primary_outcome_human_review_queue.csv`；审核完成前保持全部主要结局为 `provisional`。