W1-C1: archive 仓创建与旧 ADR 归档迁移（重订宪法主体）

[randypanding]

父意图: #161 | 宪法: specs/IR-0003/constitution.md §1/§9 | 波次: W1 | 依赖: 无 | 预算: BUDGET-01
走 flows.new_repo + GM-4 申报；agent-registry 变更走 C2；adr-required 关卡变更走 C1+ADR。

任务

archive 仓创建与旧法归档：新仓 archive（public），agent-registry/decisions/ 全部旧 ADR
逐条标 active / superseded / archived 并迁移，agent-registry 留墓碑索引
（ADR 编号 → 状态 → archive 路径），adr-required 关卡改查索引。

AC（Given-When-Then）

• AC-1 (api): Given 迁移完成，When 对全部历史 ADR 编号解析，Then 每个编号经墓碑索引可解析到 archive 仓路径，无内容丢失（逐条 diff 校验）。
• AC-2 (api): Given 一个引用真实历史 ADR 的 C1 PR，When adr-required 关卡运行，Then 查索引通过；引用不存在编号则 fail（防幽灵 ADR 语义不回归）。
• AC-3 (api): Given archive 仓，When drift-check §7 运行，Then REPOS.yaml 申报与线上状态一致（L1、public、active）。

blastRadius（预测）

agent-registry: decisions/**, registry/**; Cloudbird-Software/.github: governance/REPOS.yaml; 新仓 archive

[randypanding]

协调提示：#96（ADR 实质校验）与本卡的 adr-required 关卡变更存在先后依赖——本卡先落地墓碑索引查询，#96 的实质校验在其后扩展。认领本卡的 agent 请在设计索引格式时为实质校验预留扩展点。

[randypanding]

/claim

[randypanding]

W1-C1 phase 1 进度（子代理交付，phase 2 待主代理刷新合并）

已完成

项	状态	证据
ADR-0053	已合并	agent-registry PR #72，main=345a168
archive 仓	已建（public/L1）	bootstrap commit a32f0fcea2bc7b422ad8ad1463a8ad4a92cbeb60；new-repo-init 全步骤（squash 基线/production env/App 挂载 installation#154584760）完成
迁移 PR	绿，保持 OPEN	agent-registry PR #73（INDEX.yaml + 56 墓碑 + migrate_adrs.py + overrides；合并前置见 body）
索引感知 PR	绿，保持 OPEN	.github PR #174（gate adr-required 双世界 + drift-check §10 内容源切换 + REPOS.yaml 申报 + 直推豁免登记）
phase 2 staging	本地备好	D:\Projects\all\w1c1\archive-phase2（w1c1-content 分支已提交：adr/ 56 正本 + scripts/verify_migration.py + .github/workflows/verify.yml）

生命周期分类（逐个通读 56 个 ADR @ 345a168；拿不准=active）

active 50 / superseded 4 / archived 2

• superseded→ADR-0010：ADR-0007/0008/0009（"被推翻的先前决策"表显式列出——七分类经 v2 十原型至 v3 重构；profiles v1 机制"全部由 v2 取代"）
• superseded→ADR-0020：ADR-0019（单仓公开被全仓政策吸收，其 exempt 豁免条款被 0020 显式废除）
• archived：ADR-0017、ADR-0030（一次性破玻璃事件回填，处置闭环无持续义务；expected-state 豁免条目仍以之为登记背书）
• 理由逐条在 agent-registry scripts/migrate_overrides.yaml 的 rationale 字段

本地验证（全绿）

• agent-registry 套件：validate ✓ / simulate 24 场景 ✓ / pytest 60 passed ✓
• 三向保真闭环：(a) 56 entries sha256↔staging 正本一致 (b) 零孤儿 (c) source_commit=345a168 源 blob sha256 一致；git blob 级证明：56/56 blob SHA 与源完全相同（同 blob=同字节，AC-1 最强形态）
• 负向注入：篡改正本/孤儿文件均 fail-closed 检出
• 重构后的 gate.yml 已在 feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 实跑：OK adr-required[legacy]: … ADR-0053（旧世界回退验证 ✓；索引世界映射 python/awk 双实现对照一致）

已知事项

1. bootstrap 直推操作方式（ADR-0046 后 org-required-workflows 无 bypass，空仓首推被 required workflow 拦截）：对 org ruleset 21080096 做秒级临时 exclude [archive] → contents API 建 commit → 即刻还原；ruleset 终态与落盘一致（§1 对账不受影响）。已写入 expected-state.json comment。
2. 建仓→feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 合并之间，小时级 drift §7b/§8 报 archive 未申报/直推漂移——预期内，feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 合并自动转绿。
3. PR body 中出现假设性 ADR 编号（曾写 ADR-0052/0055）会被 org-adr-required 判幽灵 ADR——已清除；org-gate 不订阅 edited 事件，rerun 复用旧事件快照，需 push 新 commit 重触发（经验记录）。
4. 并行 W1 卡已合入 ADR-0054/0056/0057（已含在 56 entries）；0052/0055 编号空位——若 phase 2 前有新 ADR 落 decisions/，按 fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73 body 的刷新步骤重跑 migrate_adrs.py。

phase 2 合并序（主代理）

1. 全部 W1 ADR 落 decisions/ 后刷新 fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73（reset 到新 main 重跑 python scripts/migrate_adrs.py，staging 同步重生成）
2. 合并 .github feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174（旧世界行为=现 main，合并即安全）
3. 紧接合并 fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73（merge queue）
4. 立即推 archive-phase2 的 w1c1-content 分支开 PR 并合并（步骤 3→4 窗口内新开 C1 PR 的 adr-required 会因 archive raw 404 变红，落位后重跑即绿；窗口内 drift §10 可能报一次瞬时漂移，下轮自愈）
5. 复核：drift-check 全绿（archive 申报/豁免生效）；被引用 ADR 的 C1 PR 在索引世界通过；archive verify workflow 首跑绿

[randypanding]

追更（phase 1 收口）

1. 迁移基线刷新：agent-registry main 推进到 5832f4e（并行合入 ADR-0058），已按 phase-2 刷新流程实测重跑——PR #73 现为 57 entries（active 51 / superseded 4 / archived 2），全绿 CLEAN。刷新要点已写进 fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73 body：reset 到新 main 后须先从旧分支 tip 恢复 scripts/migrate_adrs.py 与 migrate_overrides.yaml 再跑（脚本在分支上不在 main）。
2. feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 rebase：.github main 推进（arbiter 申报 chore(governance): 申报 arbiter 仓入图 + bootstrap 豁免（W1-C2 #165，ADR-0054） #177 / 豁免修复 fix: 豁免数组回归修复 + §12 (a) 泛化（ADR-0058、ADR-0034） #178），feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 已 rebase 到 d55d36e（expected-state.json 豁免注释与 arbiter 键冲突已解：两方内容均保留），全绿 CLEAN。
3. phase 2 staging 就绪：w1c1/archive-phase2/（w1c1-content 分支）：adr/ 57 正本 + scripts/verify_migration.py + .github/workflows/verify.yml——57/57 git blob SHA 与源 commit 完全一致（同 blob=同字节）。verify.yml 的 setup-python SHA 已按主代理勘误修正为 40 字符正确值。
4. ruleset 说明：archive bootstrap 时的 org ruleset 临时 exclude 已秒级还原；随后 main 侧 chore(governance): 申报 arbiter 仓入图 + bootstrap 豁免（W1-C2 #165，ADR-0054） #177 已把 do_not_enforce_on_create: false 落进 ruleset 落盘文件，live 与落盘现完全一致（12:02 drift §1 实测 OK）。
5. 观察（供主代理核查，非本卡范围）：fix: 豁免数组回归修复 + §12 (a) 泛化（ADR-0058、ADR-0034） #178 落盘的 Shorts_Director 豁免 SHA 疑似有误——d81fea9db47e065fd2bd0e254449862fc4a3c91b6 中段与 mutual 的 f5d9b5b5 尾段相同，014f3898…99fa1 尾段也与旧值不同；12:02 drift §8 仍把 014f3898/d81fea9d 报为未豁免直推（P0）。建议比对实际 commit SHA（gh api repos/Cloudbird-Software/Shorts_Director/commits）。

[randypanding]

进度核对（owner 盘点）：archive 仓已创建 ✓（ADRs 0053 在案），但按本卡 AC 仍有缺口：① AC-1 旧 ADR 迁移未执行（archive 仓目前只有 README）；② 墓碑索引未见（agent-registry/decisions/ 旧 ADR 仍在原处）；③ AC-2 adr-required 改查索引未见。请认领 agent 按 AC-1/2/3 补齐；索引格式记得为 #96 的实质校验预留扩展点。

[randypanding]

W1-C1 交付摘要（phase 2 刷新+合并序完成；AC-1/2/3 证据齐——请 owner 核对，不自行关单）

合并序实况（窗口最小化）

1. agent-registry #73（刷新到 bf8f4a7：吸收并行合入的 ADR-0055/0059，57→59 entries；分支误入的 __pycache__ 构件已清）→ 全绿后合并 = cd5b2b16
2. archive PR #1（预开，gate 因 INDEX 未上 main 报 404 fail-closed 属预期）→ fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73 合并后重跑 gate 即绿 → 合并 = a6c49f9a（两合并间隔 ~2 分钟，窗口内 .github 新开 C1 PR 的 raw 可达性检查会瞬时红，重跑即绿——实测无 PR 受影响）
3. .github #207（交付 3 收口，见下）→ 合并 = 46fa5de3

迁移计数（AC-1，对应卡"decisions/ 原数 = archive 迁入 + 留存"）

• decisions/ 原数（bf8f4a7）= 59 文件（0001–0051、0053–0059；0052 空号；ADR-0011 双档）
• archive 迁入 = 59（正本全量）；agent-registry 留存 = 同名墓碑 59 + INDEX.yaml（编号可解析性零损失，org-gate 文件名校验零级联）
• lifecycle：active 53 / superseded 4（0007/0008/0009→0010，0019→0020）/ archived 2（0017、0030；rationale 逐条在 fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73 的 migrate_overrides.yaml）

AC 证据

AC	证据
AC-1 无内容丢失	① 59/59 git blob SHA 与源 commit 完全一致（同 blob=同字节）；② verify_migration 三向 sha256 闭环（INDEX↔正本↔源 commit）本地 + archive CI push-main 首跑绿（run 32492489271）；③ 负向注入（篡改正本/孤儿文件）fail-closed 检出
AC-2 引用真实 ADR 过检 / 幽灵 fail	正向：PR #207 gate 实跑 OK adr-required[index]: ADR-0053（存在性+正本可达性已验，archived 不可引）（run 32493801574）——索引世界 INDEX 命中 + archive raw 200。负向：一次性 PR #211（已验闭）实跑双拒绝：引用的 ADR-9999 不在 INDEX entries（幽灵 ADR） + 引用的 ADR-0017 生命周期=archived（历史回填，不可作为新决策依据）（run 32494051494）——防幽灵语义不回归 ✓
AC-3 archive 申报一致	drift-check（run 32494226350）：§7 REPOS map 'archive' OK（全 14 仓 OK）；§10 adr-index（索引世界：59 entries，实体性改验 archive 正本） + adr-reference-substantive 双 OK；archive bootstrap a32f0fce 在 §8 豁免清单 OK

#96 扩展点（按卡内协调提示预留）

INDEX entry 骨架以 number/file/lifecycle/decision_status/archive_path/content_sha256(+superseded_by/rationale) 为键；gate/§10 只消费 number/archive_path/lifecycle，substantive（scope 覆盖 diff 路径等）字段位已在 INDEX 头注释与 gate.yml 注释显式预留，#96 扩展不破坏现有关卡。

过程发现（两项）

1. feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 潜伏 bug 修复（feat(gate): adr-required 索引世界拒引 lifecycle=archived 的 ADR（W1-C1 #164 交付 3，ADR-0053） #207 一并）：gate 索引世界的内联 python3 -c '…' 多行代码继承 YAML 缩进 → 首语句 IndentationError。feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 合并后所有 PR 走 legacy 世界从未执行到该路径；fix: 治理层对齐——ruleset 合并解锁+GOVERNANCE 口径+组织地图+gate 存在性（ADR-0021） #73 合并（INDEX 上 main）后 feat(gate): adr-required 索引世界拒引 lifecycle=archived 的 ADR（W1-C1 #164 交付 3，ADR-0053） #207 成为首个索引世界 PR 即暴露（若不修，所有 .github C1 PR 全红）。修复：解析抽成 scripts/adr_index_map.py（可本地测试），gate 调用之。
2. 交付 3 收口（feat(gate): adr-required 索引世界拒引 lifecycle=archived 的 ADR（W1-C1 #164 交付 3，ADR-0053） #207）：feat(governance): adr-required/§10 索引感知 + archive 申报（W1-C1 #164，ADR-0053） #174 版索引世界未过滤 lifecycle——W1-C1: archive 仓创建与旧 ADR 归档迁移（重订宪法主体） #164 要求 archived 不可被新 PR 引用为新决策依据。feat(gate): adr-required 索引世界拒引 lifecycle=archived 的 ADR（W1-C1 #164 交付 3，ADR-0053） #207 落地拒引（见 AC-2 负向证据第二条）。

环境事项（非本卡回归，供 owner 处置）

drift 14:54 轮的 §1/§2/§5 报"ruleset 不存在/org secret 缺失/基线 got=null"——GOVERNANCE_TOKEN 在 12:02–14:54 间失效（12:02 轮同节全 OK；13:17 #198 提交信息已现"GOVERNANCE_TOKEN 标签可见性问题"端倪，早于本卡任何合并）。实测 ruleset/org-gate 均在且正常执法（#207/#211 的 org-gate 实跑为证）——纯检测器侧失明。建议 org admin 轮换 GOVERNANCE_TOKEN 后下轮 drift 自愈。

其他

• 本地验证：agent-registry validate ✓ / simulate 24 场景 ✓ / pytest 60 passed ✓（刷新后复跑）
• negtest 分支已删；archive 周扫 verify（周一 04:23 UTC 错峰）将长效守三向闭环